qingflow-mcp 0.3.8 → 0.3.10

package/README.md

@@ -161,17 +161,20 @@ Summary mode output:
 
 1. `summary`: aggregated stats (`total_count`, `total_amount`, `by_day`, `missing_count`).
 2. `rows`: strict column rows (only requested `select_columns`).
-3. `meta`: field mapping, filter scope, stat policy, execution limits.
+3. `meta`: field mapping, filter scope, stat policy, execution limits (`output_profile=verbose` only).
 
 Return shape:
 
-1. success: structured payload `{ "ok": true, "data": ..., "meta": ... }`
+1. success: structured payload `{ "ok": true, "data": ... }` (`meta` only in `output_profile=verbose`)
 2. failure: MCP `isError=true`, and text content is JSON payload like `{ "ok": false, "message": ..., ... }`
 3. incomplete strict queries fail with `{ "code": "NEED_MORE_DATA", "status": "need_more_data", ... }`
 
 Deterministic read protocol (list/summary/aggregate):
 
-1. `completeness` is always returned:
+1. output profile:
+   - default `output_profile=compact`: return core data only (`rows/row/groups/summary` + `next_page_token`)
+   - `output_profile=verbose`: include full contract (`completeness` + `evidence` + `meta`)
+2. when `output_profile=verbose`, `completeness` fields are:
    - `result_amount`
    - `returned_items`
    - `fetched_pages`
@@ -183,15 +186,14 @@ Deterministic read protocol (list/summary/aggregate):
    - `partial`
    - `omitted_items`
    - `omitted_chars`
-2. `evidence` is always returned:
+3. when `output_profile=verbose`, `evidence` fields are:
    - `query_id`
    - `app_key`
    - `filters`
    - `selected_columns`
    - `time_range`
    - `source_pages`
-3. `strict_full=true` makes incomplete results fail fast with `NEED_MORE_DATA`.
-4. Success payloads also expose top-level `error_code=null`, `fix_hint=null`, `next_page_token`.
+4. `strict_full=true` makes incomplete results fail fast with `NEED_MORE_DATA`.
 5. Error payloads expose `error_code` and `fix_hint` for actionable retries.
 6. Parameter tolerance supports stringified JSON and numeric/boolean strings for key query fields.
 
@@ -201,17 +203,17 @@ Strict mode (`qf_records_list`):
 
 1. `select_columns` is required.
 2. `include_answers=false` is not allowed.
-3. Output `items[].answers` contains only selected columns, not full answers.
+3. Output is flat `rows[]` (no raw `answers` payload).
 
 1. For `qf_records_list.sort[].que_id`, use a real field `que_id` (numeric) or exact field title from `qf_form_get`.
 2. Avoid aliases like `create_time`; Qingflow often rejects them.
 3. Use `max_rows` (or `max_items`) to cap returned rows. Default row cap is 200.
-4. Use `max_columns` to cap answers per row when `include_answers=true`.
+4. Use `max_columns` to cap returned columns per row.
 5. Use `select_columns` to return only specific columns (supports `que_id` or exact field title).
 6. The server may still trim by response-size guardrail (`QINGFLOW_LIST_MAX_ITEMS_BYTES`) when payload is too large.
 7. Use `requested_pages` and `scan_max_pages` for deterministic page scan.
 8. Continue with `page_token` from previous `next_page_token`.
-9. Column limits: `select_columns <= 10`, `max_columns <= 10`.
+9. Column limits: `select_columns <= 3`, `max_columns <= 3`.
 
 Example:
 
@@ -224,8 +226,9 @@ Example:
   "scan_max_pages": 1,
   "include_answers": true,
   "max_rows": 10,
-  "max_columns": 5,
+  "max_columns": 3,
   "select_columns": [1, "客户名称", "1003"],
+  "output_profile": "compact",
   "strict_full": false
 }
 ```
@@ -235,8 +238,9 @@ For single record details (`qf_record_get`), the same column controls are suppor
 ```json
 {
   "apply_id": "497600278750478338",
-  "max_columns": 5,
-  "select_columns": [1, "客户名称"]
+  "max_columns": 3,
+  "select_columns": [1, "客户名称"],
+  "output_profile": "compact"
 }
 ```
 

package/dist/server.js

@@ -46,10 +46,12 @@ const formCache = new Map();
 const DEFAULT_PAGE_SIZE = 50;
 const DEFAULT_SCAN_MAX_PAGES = 10;
 const DEFAULT_ROW_LIMIT = 200;
+const MAX_COLUMN_LIMIT = 3;
+const DEFAULT_OUTPUT_PROFILE = "compact";
 const MAX_LIST_ITEMS_BYTES = toPositiveInt(process.env.QINGFLOW_LIST_MAX_ITEMS_BYTES) ?? 400000;
 const REQUEST_TIMEOUT_MS = toPositiveInt(process.env.QINGFLOW_REQUEST_TIMEOUT_MS) ?? 18000;
 const EXECUTION_BUDGET_MS = toPositiveInt(process.env.QINGFLOW_EXECUTION_BUDGET_MS) ?? 20000;
-const SERVER_VERSION = "0.3.8";
+const SERVER_VERSION = "0.3.10";
 const accessToken = process.env.QINGFLOW_ACCESS_TOKEN;
 const baseUrl = process.env.QINGFLOW_BASE_URL;
 if (!accessToken) {
@@ -119,6 +121,7 @@ const apiMetaSchema = z.object({
     provider_err_msg: z.string().nullable(),
     base_url: z.string()
 });
+const outputProfileSchema = z.enum(["compact", "verbose"]);
 const completenessSchema = z.object({
     result_amount: z.number().int().nonnegative(),
     returned_items: z.number().int().nonnegative(),
@@ -148,11 +151,12 @@ const evidenceSchema = z.object({
     source_pages: z.array(z.number().int().positive())
 });
 const queryContractFields = {
-    completeness: completenessSchema,
-    evidence: z.record(z.unknown()),
-    error_code: z.null(),
-    fix_hint: z.null(),
-    next_page_token: z.string().nullable()
+    output_profile: outputProfileSchema.optional(),
+    completeness: completenessSchema.optional(),
+    evidence: z.record(z.unknown()).optional(),
+    error_code: z.null().optional(),
+    fix_hint: z.null().optional(),
+    next_page_token: z.string().nullable().optional()
 };
 const appSchema = z.object({
     appKey: z.string(),
@@ -165,14 +169,6 @@ const fieldSummarySchema = z.object({
     has_sub_fields: z.boolean(),
     sub_field_count: z.number().int().nonnegative()
 });
-const recordItemSchema = z.object({
-    apply_id: z.union([z.string(), z.number(), z.null()]),
-    app_key: z.string().nullable(),
-    apply_num: z.union([z.number(), z.string(), z.null()]),
-    apply_time: z.string().nullable(),
-    last_update_time: z.string().nullable(),
-    answers: z.array(z.unknown()).optional()
-});
 const operationResultSchema = z.object({
     request_id: z.string(),
     operation_result: z.unknown()
@@ -293,15 +289,16 @@ const listInputSchema = z
         .optional(),
     max_rows: z.number().int().positive().max(200).optional(),
     max_items: z.number().int().positive().max(200).optional(),
-    max_columns: z.number().int().positive().max(10).optional(),
+    max_columns: z.number().int().positive().max(MAX_COLUMN_LIMIT).optional(),
     // Strict mode: callers must explicitly choose columns.
     select_columns: z
         .array(z.union([z.string().min(1), z.number().int()]))
         .min(1)
-        .max(10)
+        .max(MAX_COLUMN_LIMIT)
         .optional(),
     include_answers: z.boolean().optional(),
-    strict_full: z.boolean().optional()
+    strict_full: z.boolean().optional(),
+    output_profile: outputProfileSchema.optional()
 }))
     .refine((value) => value.include_answers !== false, {
     message: "include_answers=false is not allowed in strict column mode"
@@ -319,7 +316,7 @@ const listSuccessOutputSchema = z.object({
             page_amount: z.number().int().nonnegative().nullable(),
             result_amount: z.number().int().nonnegative()
         }),
-        items: z.array(recordItemSchema),
+        rows: z.array(z.record(z.unknown())),
         applied_limits: z
             .object({
             include_answers: z.boolean(),
@@ -328,43 +325,43 @@ const listSuccessOutputSchema = z.object({
             selected_columns: z.array(z.string())
         })
             .optional(),
-        completeness: completenessSchema,
-        evidence: evidenceSchema
+        completeness: completenessSchema.optional(),
+        evidence: evidenceSchema.optional()
     }),
     ...queryContractFields,
-    meta: apiMetaSchema
+    meta: apiMetaSchema.optional()
 });
 const listOutputSchema = listSuccessOutputSchema;
 const recordGetInputSchema = z.preprocess(normalizeRecordGetInput, z.object({
     apply_id: z.union([z.string().min(1), z.number().int()]),
-    max_columns: z.number().int().positive().max(10).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()]))
         .min(1)
-        .max(10)
-        .optional()
+        .max(MAX_COLUMN_LIMIT)
+        .optional(),
+    output_profile: outputProfileSchema.optional()
 }));
 const recordGetSuccessOutputSchema = z.object({
     ok: z.literal(true),
     data: z.object({
         apply_id: z.union([z.string(), z.number(), z.null()]),
-        answer_count: z.number().int().nonnegative(),
-        record: z.unknown(),
+        row: z.record(z.unknown()),
         applied_limits: z
             .object({
             column_cap: z.number().int().positive().nullable(),
             selected_columns: z.array(z.string()).nullable()
         })
             .optional(),
-        completeness: completenessSchema,
+        completeness: completenessSchema.optional(),
         evidence: z.object({
             query_id: z.string(),
             apply_id: z.string(),
             selected_columns: z.array(z.string())
-        })
+        }).optional()
     }),
     ...queryContractFields,
-    meta: apiMetaSchema
+    meta: apiMetaSchema.optional()
 });
 const recordGetOutputSchema = recordGetSuccessOutputSchema;
 const createInputSchema = z
@@ -476,11 +473,11 @@ const queryInputSchema = z
         .optional(),
     max_rows: z.number().int().positive().max(200).optional(),
     max_items: z.number().int().positive().max(200).optional(),
-    max_columns: z.number().int().positive().max(10).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()]))
         .min(1)
-        .max(10)
+        .max(MAX_COLUMN_LIMIT)
         .optional(),
     include_answers: z.boolean().optional(),
     amount_column: z.union([z.string().min(1), z.number().int()]).optional(),
@@ -499,7 +496,8 @@ const queryInputSchema = z
     })
         .optional(),
     scan_max_pages: z.number().int().positive().max(500).optional(),
-    strict_full: z.boolean().optional()
+    strict_full: z.boolean().optional(),
+    output_profile: outputProfileSchema.optional()
 }))
     .refine((value) => !(value.page_num !== undefined && value.page_token !== undefined), {
     message: "page_num and page_token cannot be used together"
@@ -516,8 +514,8 @@ const querySummaryOutputSchema = z.object({
         missing_count: z.number().int().nonnegative()
     }),
     rows: z.array(z.record(z.unknown())),
-    completeness: completenessSchema,
-    evidence: evidenceSchema,
+    completeness: completenessSchema.optional(),
+    evidence: evidenceSchema.optional(),
     meta: z.object({
         field_mapping: z.array(z.object({
             role: z.enum(["row", "amount", "time"]),
@@ -549,7 +547,7 @@ const querySummaryOutputSchema = z.object({
             column_cap: z.number().int().positive().nullable(),
             scan_max_pages: z.number().int().positive()
         })
-    })
+    }).optional()
 });
 const querySuccessOutputSchema = z.object({
     ok: z.literal(true),
@@ -561,7 +559,7 @@ const querySuccessOutputSchema = z.object({
         summary: querySummaryOutputSchema.optional()
     }),
     ...queryContractFields,
-    meta: apiMetaSchema
+    meta: apiMetaSchema.optional()
 });
 const queryOutputSchema = querySuccessOutputSchema;
 const aggregateInputSchema = z
@@ -628,7 +626,8 @@ const aggregateInputSchema = z
     })
         .optional(),
     max_groups: z.number().int().positive().max(2000).optional(),
-    strict_full: z.boolean().optional()
+    strict_full: z.boolean().optional(),
+    output_profile: outputProfileSchema.optional()
 }))
     .refine((value) => !(value.page_num !== undefined && value.page_token !== undefined), {
     message: "page_num and page_token cannot be used together"
@@ -648,8 +647,8 @@ const aggregateOutputSchema = z.object({
             amount_total: z.number().nullable(),
             amount_ratio: z.number().nullable()
         })),
-        completeness: completenessSchema,
-        evidence: evidenceSchema,
+        completeness: completenessSchema.optional(),
+        evidence: evidenceSchema.optional(),
         meta: z.object({
             field_mapping: z.array(z.object({
                 role: z.enum(["group_by", "amount", "time"]),
@@ -662,10 +661,10 @@ const aggregateOutputSchema = z.object({
                 include_negative: z.boolean(),
                 include_null: z.boolean()
             })
-        })
+        }).optional()
     }),
     ...queryContractFields,
-    meta: apiMetaSchema
+    meta: apiMetaSchema.optional()
 });
 server.registerTool("qf_tool_spec_get", {
     title: "Qingflow Tool Spec Get",
@@ -841,8 +840,8 @@ server.registerTool("qf_query", {
         if (routedMode === "record") {
             const recordArgs = buildRecordGetArgsFromQuery(args);
             const executed = await executeRecordGet(recordArgs);
-            const completeness = executed.payload.completeness;
-            const evidence = executed.payload.evidence;
+            const completeness = executed.completeness;
+            const evidence = executed.evidence;
             return okResult({
                 ok: true,
                 data: {
@@ -850,18 +849,27 @@ server.registerTool("qf_query", {
                     source_tool: "qf_record_get",
                     record: executed.payload.data
                 },
-                completeness,
-                evidence,
-                error_code: null,
-                fix_hint: null,
+                output_profile: executed.outputProfile,
+                ...(isVerboseProfile(executed.outputProfile)
+                    ? {
+                        completeness,
+                        evidence,
+                        error_code: null,
+                        fix_hint: null
+                    }
+                    : {}),
                 next_page_token: completeness.next_page_token,
-                meta: executed.payload.meta
+                ...(isVerboseProfile(executed.outputProfile)
+                    ? {
+                        meta: executed.payload.meta
+                    }
+                    : {})
             }, executed.message);
         }
         if (routedMode === "summary") {
             const executed = await executeRecordsSummary(args);
-            const completeness = executed.data.completeness;
-            const evidence = executed.data.evidence;
+            const completeness = executed.completeness;
+            const evidence = executed.evidence;
             return okResult({
                 ok: true,
                 data: {
@@ -869,18 +877,27 @@ server.registerTool("qf_query", {
                     source_tool: "qf_records_summary",
                     summary: executed.data
                 },
-                completeness,
-                evidence,
-                error_code: null,
-                fix_hint: null,
+                output_profile: executed.outputProfile,
+                ...(isVerboseProfile(executed.outputProfile)
+                    ? {
+                        completeness,
+                        evidence,
+                        error_code: null,
+                        fix_hint: null
+                    }
+                    : {}),
                 next_page_token: completeness.next_page_token,
-                meta: executed.meta
+                ...(isVerboseProfile(executed.outputProfile)
+                    ? {
+                        meta: executed.meta
+                    }
+                    : {})
             }, executed.message);
         }
         const listArgs = buildListArgsFromQuery(args);
         const executed = await executeRecordsList(listArgs);
-        const completeness = executed.payload.completeness;
-        const evidence = executed.payload.evidence;
+        const completeness = executed.completeness;
+        const evidence = executed.evidence;
         return okResult({
             ok: true,
             data: {
@@ -888,12 +905,21 @@ server.registerTool("qf_query", {
                 source_tool: "qf_records_list",
                 list: executed.payload.data
             },
-            completeness,
-            evidence,
-            error_code: null,
-            fix_hint: null,
+            output_profile: executed.outputProfile,
+            ...(isVerboseProfile(executed.outputProfile)
+                ? {
+                    completeness,
+                    evidence,
+                    error_code: null,
+                    fix_hint: null
+                }
+                : {}),
             next_page_token: completeness.next_page_token,
-            meta: executed.payload.meta
+            ...(isVerboseProfile(executed.outputProfile)
+                ? {
+                    meta: executed.payload.meta
+                }
+                : {})
         }, executed.message);
     }
     catch (error) {
@@ -1288,6 +1314,12 @@ function buildMeta(response) {
         base_url: baseUrl
     };
 }
+function resolveOutputProfile(value) {
+    return value === "verbose" ? "verbose" : DEFAULT_OUTPUT_PROFILE;
+}
+function isVerboseProfile(profile) {
+    return profile === "verbose";
+}
 function missingRequiredFieldError(params) {
     return new InputValidationError({
         message: `Missing required field "${params.field}" for ${params.tool}`,
@@ -1335,6 +1367,9 @@ const COMMON_INPUT_ALIASES = {
     statPolicy: "stat_policy",
     groupBy: "group_by",
     strictFull: "strict_full",
+    outputProfile: "output_profile",
+    responseProfile: "output_profile",
+    profile: "output_profile",
     forceRefresh: "force_refresh",
     forceRefreshForm: "force_refresh_form",
     applyUser: "apply_user"
@@ -1416,8 +1451,9 @@ function buildToolSpecCatalog() {
                 scan_max_pages_max: 500,
                 max_rows_max: 200,
                 max_items_max: 200,
-                max_columns_max: 10,
-                select_columns_max: 10
+                max_columns_max: MAX_COLUMN_LIMIT,
+                select_columns_max: MAX_COLUMN_LIMIT,
+                output_profile: "compact|verbose (default compact)"
             },
             aliases: collectAliasHints([
                 "app_key",
@@ -1431,35 +1467,41 @@ function buildToolSpecCatalog() {
                 "max_items",
                 "max_columns",
                 "select_columns",
+                "output_profile",
                 "strict_full",
                 "include_answers",
                 "time_range"
             ], {
                 select_columns: ["columns", "selected_columns", "selectedColumns"],
-                max_rows: ["limit", "row_limit", "rowLimit"]
+                max_rows: ["limit", "row_limit", "rowLimit"],
+                output_profile: ["outputProfile", "responseProfile", "profile"]
             }),
             minimal_example: {
                 app_key: "21b3d559",
                 mode: "all",
                 page_size: 50,
                 max_rows: 20,
-                select_columns: [0, "客户名称", "报价总金额"]
+                select_columns: [0, "客户名称", "报价总金额"],
+                output_profile: "compact"
             }
         },
         {
             tool: "qf_record_get",
             required: ["apply_id", "select_columns"],
             limits: {
-                max_columns_max: 10,
-                select_columns_max: 10
+                max_columns_max: MAX_COLUMN_LIMIT,
+                select_columns_max: MAX_COLUMN_LIMIT,
+                output_profile: "compact|verbose (default compact)"
             },
-            aliases: collectAliasHints(["apply_id", "max_columns", "select_columns"], {
-                select_columns: ["columns", "selected_columns", "selectedColumns"]
+            aliases: collectAliasHints(["apply_id", "max_columns", "select_columns", "output_profile"], {
+                select_columns: ["columns", "selected_columns", "selectedColumns"],
+                output_profile: ["outputProfile", "responseProfile", "profile"]
             }),
             minimal_example: {
                 apply_id: "497600278750478338",
                 select_columns: [0, "客户名称"],
-                max_columns: 5
+                max_columns: 3,
+                output_profile: "compact"
             }
         },
         {
@@ -1476,8 +1518,9 @@ function buildToolSpecCatalog() {
                 scan_max_pages_max: 500,
                 max_rows_max: 200,
                 max_items_max: 200,
-                max_columns_max: 10,
-                select_columns_max: 10
+                max_columns_max: MAX_COLUMN_LIMIT,
+                select_columns_max: MAX_COLUMN_LIMIT,
+                output_profile: "compact|verbose (default compact)"
             },
             aliases: collectAliasHints([
                 "query_mode",
@@ -1492,6 +1535,7 @@ function buildToolSpecCatalog() {
                 "max_items",
                 "max_columns",
                 "select_columns",
+                "output_profile",
                 "amount_column",
                 "time_range",
                 "stat_policy",
@@ -1500,7 +1544,8 @@ function buildToolSpecCatalog() {
                 select_columns: ["columns", "selected_columns", "selectedColumns"],
                 max_rows: ["limit", "row_limit", "rowLimit"],
                 amount_column: ["amount_que_ids", "amountQueIds", "amountColumns"],
-                time_range: ["date_field + date_from + date_to"]
+                time_range: ["date_field + date_from + date_to"],
+                output_profile: ["outputProfile", "responseProfile", "profile"]
             }),
             minimal_example: {
                 query_mode: "list",
@@ -1509,6 +1554,7 @@ function buildToolSpecCatalog() {
                 page_size: 50,
                 max_rows: 20,
                 select_columns: [0, "客户名称", "报价总金额"],
+                output_profile: "compact",
                 time_range: {
                     column: 6299264,
                     from: "2026-03-05",
@@ -1524,7 +1570,8 @@ function buildToolSpecCatalog() {
                 requested_pages_max: 500,
                 scan_max_pages_max: 500,
                 max_groups_max: 2000,
-                group_by_max: 20
+                group_by_max: 20,
+                output_profile: "compact|verbose (default compact)"
             },
             aliases: collectAliasHints([
                 "app_key",
@@ -1535,18 +1582,21 @@ function buildToolSpecCatalog() {
                 "page_size",
                 "requested_pages",
                 "scan_max_pages",
+                "output_profile",
                 "time_range",
                 "stat_policy",
                 "strict_full"
             ], {
                 amount_column: ["amount_que_ids", "amountQueIds", "amountColumns"],
-                time_range: ["date_field + date_from + date_to"]
+                time_range: ["date_field + date_from + date_to"],
+                output_profile: ["outputProfile", "responseProfile", "profile"]
             }),
             minimal_example: {
                 app_key: "21b3d559",
                 mode: "all",
                 group_by: [9500572],
                 amount_column: 6299263,
+                output_profile: "compact",
                 time_range: {
                     column: 6299264,
                     from: "2026-03-05",
@@ -1647,6 +1697,7 @@ function normalizeListInput(raw) {
         max_columns: coerceNumberLike(normalizedObj.max_columns),
         strict_full: coerceBooleanLike(normalizedObj.strict_full),
         include_answers: coerceBooleanLike(normalizedObj.include_answers),
+        output_profile: normalizeOutputProfileInput(normalizedObj.output_profile),
         apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
         sort: normalizeSortInput(normalizedObj.sort),
         filters: normalizeFiltersInput(normalizedObj.filters),
@@ -1666,7 +1717,8 @@ function normalizeRecordGetInput(raw) {
         ...normalizedObj,
         apply_id: coerceNumberLike(normalizedObj.apply_id),
         max_columns: coerceNumberLike(normalizedObj.max_columns),
-        select_columns: normalizeSelectorListInput(selectColumns)
+        select_columns: normalizeSelectorListInput(selectColumns),
+        output_profile: normalizeOutputProfileInput(normalizedObj.output_profile)
     };
 }
 function normalizeQueryInput(raw) {
@@ -1691,6 +1743,7 @@ function normalizeQueryInput(raw) {
         apply_id: coerceNumberLike(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),
         sort: normalizeSortInput(normalizedObj.sort),
@@ -1717,6 +1770,7 @@ function normalizeAggregateInput(raw) {
         type: coerceNumberLike(normalizedObj.type),
         max_groups: coerceNumberLike(normalizedObj.max_groups),
         strict_full: coerceBooleanLike(normalizedObj.strict_full),
+        output_profile: normalizeOutputProfileInput(normalizedObj.output_profile),
         group_by: normalizeSelectorListInput(normalizedObj.group_by),
         amount_column: normalizeAmountColumnInput(normalizedObj.amount_column),
         apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
@@ -1758,6 +1812,23 @@ function coerceBooleanLike(value) {
     }
     return parsed;
 }
+function normalizeOutputProfileInput(value) {
+    const parsed = parseJsonLikeDeep(value);
+    if (typeof parsed !== "string") {
+        return parsed;
+    }
+    const normalized = parsed.trim().toLowerCase();
+    if (!normalized) {
+        return parsed;
+    }
+    if (normalized === "compact" || normalized === "lite" || normalized === "minimal") {
+        return "compact";
+    }
+    if (normalized === "verbose" || normalized === "full" || normalized === "debug") {
+        return "verbose";
+    }
+    return parsed;
+}
 function parseJsonLikeDeep(value, maxDepth = 4) {
     let current = value;
     for (let i = 0; i < maxDepth; i += 1) {
@@ -2198,7 +2269,7 @@ function buildListArgsFromQuery(args) {
         throw missingRequiredFieldError({
             field: "select_columns",
             tool: "qf_query(list)",
-            fixHint: "Provide select_columns as an array (<=10), for example: {\"select_columns\":[0,\"客户全称\",\"报价总金额\"]}"
+            fixHint: "Provide select_columns as an array (<=3), for example: {\"select_columns\":[0,\"客户全称\",\"报价总金额\"]}"
         });
     }
     const filters = buildListFiltersFromQuery(args);
@@ -2223,7 +2294,8 @@ function buildListArgsFromQuery(args) {
         max_columns: args.max_columns,
         select_columns: args.select_columns,
         include_answers: args.include_answers,
-        strict_full: args.strict_full
+        strict_full: args.strict_full,
+        output_profile: args.output_profile
     });
 }
 function buildListFiltersFromQuery(args) {
@@ -2392,13 +2464,14 @@ function buildRecordGetArgsFromQuery(args) {
         throw missingRequiredFieldError({
             field: "select_columns",
             tool: "qf_query(record)",
-            fixHint: "Provide select_columns as an array (<=10), for example: {\"select_columns\":[0,\"客户全称\"]}"
+            fixHint: "Provide select_columns as an array (<=3), for example: {\"select_columns\":[0,\"客户全称\"]}"
         });
     }
     return recordGetInputSchema.parse({
         apply_id: args.apply_id,
         max_columns: args.max_columns,
-        select_columns: args.select_columns
+        select_columns: args.select_columns,
+        output_profile: args.output_profile
     });
 }
 async function executeRecordsList(args) {
@@ -2413,9 +2486,10 @@ async function executeRecordsList(args) {
         throw missingRequiredFieldError({
             field: "select_columns",
             tool: "qf_records_list",
-            fixHint: "Provide select_columns as an array (<=10), for example: {\"select_columns\":[0,\"客户全称\",\"报价总金额\"]}"
+            fixHint: "Provide select_columns as an array (<=3), for example: {\"select_columns\":[0,\"客户全称\",\"报价总金额\"]}"
         });
     }
+    const outputProfile = resolveOutputProfile(args.output_profile);
     const queryId = randomUUID();
     const pageNum = resolveStartPage(args.page_num, args.page_token, args.app_key);
     const pageSize = args.page_size ?? DEFAULT_PAGE_SIZE;
@@ -2485,6 +2559,7 @@ async function executeRecordsList(args) {
     const items = collectedRawItems
         .slice(0, listLimit.limit)
         .map((raw) => normalizeRecordItem(raw, includeAnswers));
+    const sourceItemsForRows = items.slice();
     const columnProjection = projectRecordItemsColumns({
         items,
         includeAnswers,
@@ -2503,16 +2578,23 @@ async function executeRecordsList(args) {
             }
         });
     }
-    const fitted = fitListItemsWithinSize({
-        items: columnProjection.items,
+    const selectedColumnsForRows = args.max_columns !== undefined
+        ? columnProjection.selectedColumns.slice(0, args.max_columns)
+        : columnProjection.selectedColumns;
+    const rows = buildFlatRowsFromItems({
+        items: sourceItemsForRows,
+        selectedColumns: selectedColumnsForRows
+    });
+    const fittedRows = fitListItemsWithinSize({
+        items: rows,
         limitBytes: MAX_LIST_ITEMS_BYTES
     });
-    const truncationReason = mergeTruncationReasons(listLimit.reason, columnProjection.reason, fitted.reason);
-    const omittedItems = Math.max(0, knownResultAmount - fitted.items.length);
+    const truncationReason = mergeTruncationReasons(listLimit.reason, columnProjection.reason, fittedRows.reason);
+    const omittedItems = Math.max(0, knownResultAmount - fittedRows.items.length);
     const isComplete = !hasMore &&
         omittedItems === 0 &&
-        fitted.omittedItems === 0 &&
-        fitted.omittedChars === 0;
+        fittedRows.omittedItems === 0 &&
+        fittedRows.omittedChars === 0;
     const nextPageToken = hasMore && nextPageNum
         ? encodeContinuationToken({
             app_key: args.app_key,
@@ -2522,7 +2604,7 @@ async function executeRecordsList(args) {
         : null;
     const completeness = {
         result_amount: knownResultAmount,
-        returned_items: fitted.items.length,
+        returned_items: fittedRows.items.length,
         fetched_pages: fetchedPages,
         requested_pages: requestedPages,
         actual_scanned_pages: fetchedPages,
@@ -2531,7 +2613,7 @@ async function executeRecordsList(args) {
         is_complete: isComplete,
         partial: !isComplete,
         omitted_items: omittedItems,
-        omitted_chars: fitted.omittedChars
+        omitted_chars: fittedRows.omittedChars
     };
     const listState = {
         query_id: queryId,
@@ -2565,30 +2647,46 @@ async function executeRecordsList(args) {
                 page_amount: pageAmount,
                 result_amount: knownResultAmount
             },
-            items: fitted.items,
+            rows: fittedRows.items,
             applied_limits: {
                 include_answers: includeAnswers,
                 row_cap: listLimit.limit,
                 column_cap: args.max_columns ?? null,
-                selected_columns: columnProjection.selectedColumns
+                selected_columns: selectedColumnsForRows
             },
-            completeness,
-            evidence
+            ...(isVerboseProfile(outputProfile)
+                ? {
+                    completeness,
+                    evidence
+                }
+                : {})
         },
-        completeness,
-        evidence,
-        error_code: null,
-        fix_hint: null,
+        output_profile: outputProfile,
+        ...(isVerboseProfile(outputProfile)
+            ? {
+                completeness,
+                evidence,
+                error_code: null,
+                fix_hint: null
+            }
+            : {}),
         next_page_token: completeness.next_page_token,
-        meta: responseMeta
+        ...(isVerboseProfile(outputProfile)
+            ? {
+                meta: responseMeta
+            }
+            : {})
     };
     return {
         payload: responsePayload,
         message: buildRecordsListMessage({
-            returned: fitted.items.length,
+            returned: fittedRows.items.length,
             total: knownResultAmount,
             truncationReason
-        })
+        }),
+        completeness,
+        evidence,
+        outputProfile
     };
 }
 async function executeRecordGet(args) {
@@ -2596,9 +2694,10 @@ async function executeRecordGet(args) {
         throw missingRequiredFieldError({
             field: "select_columns",
             tool: "qf_record_get",
-            fixHint: "Provide select_columns as an array (<=10), for example: {\"apply_id\":\"...\",\"select_columns\":[0]}"
+            fixHint: "Provide select_columns as an array (<=3), for example: {\"apply_id\":\"...\",\"select_columns\":[0]}"
         });
     }
+    const outputProfile = resolveOutputProfile(args.output_profile);
     const queryId = randomUUID();
     const response = await client.getRecord(String(args.apply_id));
     const record = asObject(response.result) ?? {};
@@ -2607,65 +2706,69 @@ async function executeRecordGet(args) {
         maxColumns: args.max_columns,
         selectColumns: args.select_columns
     });
-    const projectedRecord = {
-        ...record,
-        answers: projection.answers
+    const selectedColumnsForRow = args.max_columns !== undefined
+        ? (projection.selectedColumns ?? []).slice(0, args.max_columns)
+        : projection.selectedColumns ?? [];
+    const row = buildFlatRowFromAnswers({
+        applyId: record.applyId ?? null,
+        answers: asArray(record.answers),
+        selectedColumns: selectedColumnsForRow
+    });
+    const completeness = {
+        result_amount: 1,
+        returned_items: 1,
+        fetched_pages: 1,
+        requested_pages: 1,
+        actual_scanned_pages: 1,
+        has_more: false,
+        next_page_token: null,
+        is_complete: true,
+        partial: false,
+        omitted_items: 0,
+        omitted_chars: 0
+    };
+    const evidence = {
+        query_id: queryId,
+        apply_id: String(args.apply_id),
+        selected_columns: selectedColumnsForRow
     };
-    const answerCount = projection.answers.length;
     return {
         payload: {
             ok: true,
             data: {
                 apply_id: record.applyId ?? null,
-                answer_count: answerCount,
-                record: projectedRecord,
+                row,
                 applied_limits: {
                     column_cap: args.max_columns ?? null,
-                    selected_columns: projection.selectedColumns
+                    selected_columns: selectedColumnsForRow
                 },
-                completeness: {
-                    result_amount: 1,
-                    returned_items: 1,
-                    fetched_pages: 1,
-                    requested_pages: 1,
-                    actual_scanned_pages: 1,
-                    has_more: false,
-                    next_page_token: null,
-                    is_complete: true,
-                    partial: false,
-                    omitted_items: 0,
-                    omitted_chars: 0
-                },
-                evidence: {
-                    query_id: queryId,
-                    apply_id: String(args.apply_id),
-                    selected_columns: projection.selectedColumns ?? []
-                }
-            },
-            completeness: {
-                result_amount: 1,
-                returned_items: 1,
-                fetched_pages: 1,
-                requested_pages: 1,
-                actual_scanned_pages: 1,
-                has_more: false,
-                next_page_token: null,
-                is_complete: true,
-                partial: false,
-                omitted_items: 0,
-                omitted_chars: 0
-            },
-            evidence: {
-                query_id: queryId,
-                apply_id: String(args.apply_id),
-                selected_columns: projection.selectedColumns ?? []
+                ...(isVerboseProfile(outputProfile)
+                    ? {
+                        completeness,
+                        evidence
+                    }
+                    : {})
             },
-            error_code: null,
-            fix_hint: null,
+            output_profile: outputProfile,
+            ...(isVerboseProfile(outputProfile)
+                ? {
+                    completeness,
+                    evidence,
+                    error_code: null,
+                    fix_hint: null
+                }
+                : {}),
             next_page_token: null,
-            meta: buildMeta(response)
+            ...(isVerboseProfile(outputProfile)
+                ? {
+                    meta: buildMeta(response)
+                }
+                : {})
         },
-        message: `Fetched record ${String(args.apply_id)}`
+        message: `Fetched record ${String(args.apply_id)}`,
+        completeness,
+        evidence,
+        outputProfile
     };
 }
 async function executeRecordsSummary(args) {
@@ -2680,9 +2783,10 @@ async function executeRecordsSummary(args) {
         throw missingRequiredFieldError({
             field: "select_columns",
             tool: "qf_query(summary)",
-            fixHint: "Provide select_columns as an array (<=10), for example: {\"select_columns\":[\"客户全称\"]}"
+            fixHint: "Provide select_columns as an array (<=3), for example: {\"select_columns\":[\"客户全称\"]}"
         });
     }
+    const outputProfile = resolveOutputProfile(args.output_profile);
     const queryId = randomUUID();
     const strictFull = args.strict_full ?? true;
     const includeNegative = args.stat_policy?.include_negative ?? true;
@@ -2892,44 +2996,52 @@ async function executeRecordsSummary(args) {
                 missing_count: missingCount
             },
             rows,
-            completeness,
-            evidence,
-            meta: {
-                field_mapping: fieldMapping,
-                filters: {
-                    app_key: args.app_key,
-                    time_range: timeColumn
-                        ? {
-                            column: timeColumn.requested,
-                            from: args.time_range?.from ?? null,
-                            to: args.time_range?.to ?? null,
-                            timezone
+            ...(isVerboseProfile(outputProfile)
+                ? {
+                    completeness,
+                    evidence,
+                    meta: {
+                        field_mapping: fieldMapping,
+                        filters: {
+                            app_key: args.app_key,
+                            time_range: timeColumn
+                                ? {
+                                    column: timeColumn.requested,
+                                    from: args.time_range?.from ?? null,
+                                    to: args.time_range?.to ?? null,
+                                    timezone
+                                }
+                                : null
+                        },
+                        stat_policy: {
+                            include_negative: includeNegative,
+                            include_null: includeNull
+                        },
+                        execution: {
+                            scanned_records: scannedRecords,
+                            scanned_pages: scannedPages,
+                            truncated: !isComplete,
+                            row_cap: rowCap,
+                            column_cap: args.max_columns ?? null,
+                            scan_max_pages: scanMaxPages
                         }
-                        : null
-                },
-                stat_policy: {
-                    include_negative: includeNegative,
-                    include_null: includeNull
-                },
-                execution: {
-                    scanned_records: scannedRecords,
-                    scanned_pages: scannedPages,
-                    truncated: !isComplete,
-                    row_cap: rowCap,
-                    column_cap: args.max_columns ?? null,
-                    scan_max_pages: scanMaxPages
+                    }
                 }
-            }
+                : {})
         },
         meta: summaryMeta,
         message: isComplete
             ? `Summarized ${scannedRecords} records`
-            : `Summarized ${scannedRecords}/${knownResultAmount} records (partial)`
+            : `Summarized ${scannedRecords}/${knownResultAmount} records (partial)`,
+        completeness,
+        evidence,
+        outputProfile
     };
 }
 async function executeRecordsAggregate(args) {
     const queryId = randomUUID();
     const strictFull = args.strict_full ?? true;
+    const outputProfile = resolveOutputProfile(args.output_profile);
     const includeNegative = args.stat_policy?.include_negative ?? true;
     const includeNull = args.stat_policy?.include_null ?? false;
     const pageSize = args.page_size ?? DEFAULT_PAGE_SIZE;
@@ -3127,22 +3239,35 @@ async function executeRecordsAggregate(args) {
                     total_amount: amountColumn ? totalAmount : null
                 },
                 groups,
-                completeness,
-                evidence,
-                meta: {
-                    field_mapping: fieldMapping,
-                    stat_policy: {
-                        include_negative: includeNegative,
-                        include_null: includeNull
+                ...(isVerboseProfile(outputProfile)
+                    ? {
+                        completeness,
+                        evidence,
+                        meta: {
+                            field_mapping: fieldMapping,
+                            stat_policy: {
+                                include_negative: includeNegative,
+                                include_null: includeNull
+                            }
+                        }
                     }
-                }
+                    : {})
             },
-            completeness,
-            evidence,
-            error_code: null,
-            fix_hint: null,
+            output_profile: outputProfile,
+            ...(isVerboseProfile(outputProfile)
+                ? {
+                    completeness,
+                    evidence,
+                    error_code: null,
+                    fix_hint: null
+                }
+                : {}),
             next_page_token: completeness.next_page_token,
-            meta: responseMeta
+            ...(isVerboseProfile(outputProfile)
+                ? {
+                    meta: responseMeta
+                }
+                : {})
         },
         message: isComplete
             ? `Aggregated ${scannedRecords} records`
@@ -3635,10 +3760,13 @@ function projectRecordItemsColumns(params) {
             projected = projected.slice(0, params.maxColumns);
             columnCapped = true;
         }
-        matchedAnswersCount += projected.length;
+        const slimProjected = projected
+            .map((answer) => simplifyAnswerForOutput(answer))
+            .filter((answer) => Boolean(answer));
+        matchedAnswersCount += slimProjected.length;
         return {
             ...item,
-            answers: projected
+            answers: slimProjected
         };
     });
     const reason = mergeTruncationReasons(selectorSet.size > 0 ? `selected columns=${normalizedSelectors.length}` : null, columnCapped && params.maxColumns !== undefined
@@ -3661,11 +3789,99 @@ function projectAnswersForOutput(params) {
     if (params.maxColumns !== undefined && projected.length > params.maxColumns) {
         projected = projected.slice(0, params.maxColumns);
     }
+    const slimProjected = projected
+        .map((answer) => simplifyAnswerForOutput(answer))
+        .filter((answer) => Boolean(answer));
     return {
-        answers: projected,
+        answers: slimProjected,
         selectedColumns: normalizedSelectors.length > 0 ? normalizedSelectors : null
     };
 }
+function simplifyAnswerForOutput(answer) {
+    const obj = asObject(answer);
+    if (!obj) {
+        return null;
+    }
+    const queId = obj.queId ?? obj.que_id ?? null;
+    const queTitle = asNullableString(obj.queTitle ?? obj.que_title);
+    const queType = obj.queType ?? obj.que_type;
+    const value = extractAnswerDisplayValue(obj);
+    const slim = {
+        queId,
+        queTitle
+    };
+    if (queType !== undefined && queType !== null) {
+        slim.queType = queType;
+    }
+    if (value !== undefined) {
+        slim.value = value;
+    }
+    return slim;
+}
+function buildFlatRowsFromItems(params) {
+    return params.items.map((item) => buildFlatRowFromAnswers({
+        applyId: item.apply_id ?? null,
+        answers: asArray(item.answers),
+        selectedColumns: params.selectedColumns
+    }));
+}
+function buildFlatRowFromAnswers(params) {
+    const row = {
+        apply_id: params.applyId
+    };
+    const selectors = normalizeColumnSelectors(params.selectedColumns);
+    for (const selector of selectors) {
+        const hit = findAnswerBySelector(params.answers, selector);
+        const keyBase = resolveFlatRowColumnKey(selector, hit);
+        const key = getUniqueRowKey(row, keyBase);
+        row[key] = hit ? extractAnswerDisplayValue(hit) : null;
+    }
+    return row;
+}
+function findAnswerBySelector(answers, selector) {
+    const target = normalizeColumnSelector(selector);
+    for (const answerRaw of answers) {
+        const answer = asObject(answerRaw);
+        if (!answer) {
+            continue;
+        }
+        const answerQueId = asNullableString(answer.queId ?? answer.que_id);
+        if (answerQueId && normalizeColumnSelector(answerQueId) === target) {
+            return answer;
+        }
+        const answerQueTitle = asNullableString(answer.queTitle ?? answer.que_title);
+        if (answerQueTitle && normalizeColumnSelector(answerQueTitle) === target) {
+            return answer;
+        }
+    }
+    return null;
+}
+function resolveFlatRowColumnKey(selector, answer) {
+    const trimmed = selector.trim();
+    if (!trimmed) {
+        return "column";
+    }
+    if (!isNumericKey(trimmed)) {
+        return trimmed;
+    }
+    const title = asNullableString(answer?.queTitle ?? answer?.que_title);
+    if (title && title.trim()) {
+        return title;
+    }
+    return trimmed;
+}
+function getUniqueRowKey(row, preferred) {
+    if (!(preferred in row)) {
+        return preferred;
+    }
+    let index = 2;
+    let candidate = `${preferred}#${index}`;
+    while (candidate in row) {
+        index += 1;
+        candidate = `${preferred}#${index}`;
+    }
+    return candidate;
+}
 function fitListItemsWithinSize(params) {
     let candidate = params.items;
     const originalSize = jsonSizeBytes(candidate);
@@ -4041,7 +4257,8 @@ function buildBaseExampleCall(params) {
             tool: "qf_record_get",
             arguments: {
                 apply_id: "your_apply_id",
-                select_columns: params.selectColumns
+                select_columns: params.selectColumns,
+                output_profile: "compact"
             }
         };
     }
@@ -4053,7 +4270,8 @@ function buildBaseExampleCall(params) {
                 mode: "all",
                 page_size: 50,
                 max_rows: 20,
-                select_columns: params.selectColumns
+                select_columns: params.selectColumns,
+                output_profile: "compact"
             }
         };
     }
@@ -4067,7 +4285,8 @@ function buildBaseExampleCall(params) {
                 page_size: 50,
                 requested_pages: 3,
                 scan_max_pages: 3,
-                strict_full: false
+                strict_full: false,
+                output_profile: "compact"
             }
         };
     }
@@ -4078,7 +4297,8 @@ function buildBaseExampleCall(params) {
             arguments: {
                 query_mode: "record",
                 apply_id: "your_apply_id",
-                select_columns: params.selectColumns
+                select_columns: params.selectColumns,
+                output_profile: "compact"
             }
         };
     }
@@ -4092,7 +4312,8 @@ function buildBaseExampleCall(params) {
                 select_columns: params.selectColumns,
                 page_size: 50,
                 scan_max_pages: 3,
-                strict_full: false
+                strict_full: false,
+                output_profile: "compact"
             }
         };
     }
@@ -4104,7 +4325,8 @@ function buildBaseExampleCall(params) {
             mode: "all",
             page_size: 50,
             max_rows: 20,
-            select_columns: params.selectColumns
+            select_columns: params.selectColumns,
+            output_profile: "compact"
         }
     };
 }

package/package.json

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