@qingflow-tech/qingflow-cli 1.1.56 → 1.1.58

package/src/qingflow_mcp/tools/record_tools.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import csv
 import html
 import mimetypes
 import json
@@ -33,7 +34,6 @@ from ..list_type_labels import (
 )
 from .base import ToolBase
 from .directory_tools import _directory_has_more, _directory_items
-from .csv_export import CsvShardWriter
 
 
 DEFAULT_QUERY_PAGE_SIZE = 50
@@ -2284,22 +2284,57 @@ class RecordTools(ToolBase):
                 }
 
             run_dir = _record_access_run_dir()
+            run_dir.mkdir(parents=True, exist_ok=True)
             header = ["record_id"] + [str(field["column_name"]) for field in fields_payload]
-            shard_writer = CsvShardWriter(
-                output_dir=run_dir,
-                file_prefix="records",
-                header=header,
-                shard_rows=DEFAULT_RECORD_ACCESS_SHARD_ROWS,
-            )
+            files: list[JSONObject] = []
+            shard_part = 0
+            shard_rows = 0
+            row_count = 0
+            file_handle: Any | None = None
+            writer: Any | None = None
+
+            def close_shard() -> None:
+                nonlocal file_handle, writer, shard_rows
+                if file_handle is None:
+                    return
+                path = Path(file_handle.name)
+                file_handle.close()
+                files.append(
+                    {
+                        "local_path": str(path),
+                        "row_count": shard_rows,
+                        "part": len(files) + 1,
+                    }
+                )
+                file_handle = None
+                writer = None
+                shard_rows = 0
+
+            def ensure_writer() -> Any:
+                nonlocal file_handle, writer, shard_part
+                if writer is not None:
+                    return writer
+                shard_part += 1
+                path = run_dir / f"records-{shard_part:04d}.csv"
+                file_handle = path.open("w", newline="", encoding="utf-8-sig")
+                writer = csv.writer(file_handle)
+                writer.writerow(header)
+                return writer
 
             def write_record(apply_id: int | None, answer_list: list[JSONValue]) -> None:
+                nonlocal row_count, shard_rows
                 if apply_id is None:
                     return
+                if shard_rows >= DEFAULT_RECORD_ACCESS_SHARD_ROWS:
+                    close_shard()
+                csv_writer = ensure_writer()
                 values: list[str] = [_public_record_id_text(apply_id) or ""]
                 for field in selected_fields:
                     answer = _find_answer_for_field(answer_list, field)
                     values.append(_record_access_csv_cell(_normalize_answer_field_value_for_output(answer, field)))
-                shard_writer.write(values)
+                csv_writer.writerow(values)
+                row_count += 1
+                shard_rows += 1
 
             current_page = 1
             has_more = False
@@ -2339,7 +2374,7 @@ class RecordTools(ToolBase):
                         break
                     page = fetch_page(current_page, BACKEND_RECORD_ACCESS_PAGE_SIZE)
             finally:
-                shard_writer.close_shard()
+                close_shard()
 
             if stopped_reason == "TIME_BUDGET_EXCEEDED":
                 warnings.append(_record_access_time_budget_warning(reported_total=reported_total, fetched_pages=fetched_pages))
@@ -2364,11 +2399,11 @@ class RecordTools(ToolBase):
                 "view_id": view_route.view_id,
                 "format": "csv",
                 "local_dir": str(run_dir),
-                "row_count": shard_writer.row_count,
+                "row_count": row_count,
                 "complete": complete,
                 "truncated": not complete,
                 "safe_for_final_conclusion": safe_for_final_conclusion,
-                "files": shard_writer.files,
+                "files": files,
                 "fields": fields_payload,
                 "warnings": warnings,
                 "verification": verification_payload,

package/skills/qingflow-cli/reference/data/README.md

@@ -1,32 +0,0 @@
-# Qingflow CLI 直接数据操作
-
-直接查询、读取、新增、更新和删除分别使用：
-
-- `qingflow data query`
-- `qingflow data get`
-- `qingflow data insert`
-- `qingflow data update`
-- `qingflow data delete`
-
-参数、JSON 文件形状和可选项必须来自当前工具 schema、当次 `--help` 或响应字段能力，不得从其他命令推测。
-
-## 字段能力合同
-
-1. 首次操作当前应用时，只通过只读 `data query/get` 请求 `include_schema=true`，读取同一次响应中的 `schema` 与递归 `field_capabilities`；不得用 insert/update 探测能力。
-2. 构造 `where` 时，只使用目标字段 `filter_operators` 实际暴露的 `op`，并匹配对应 `value_shape`；不要在本文复制操作符矩阵。
-3. 写入前优先执行不设置 `columns` 的只读 `data query` 并请求 schema，检查响应中的 `access`，再检查 `insertable`、`updatable` 与 `required_on_insert`。
-4. `write_kind`、schema 与当次 `--help` 共同决定 payload 形状；运行时字段错误和权限结果优先于预检。
-
-## 执行与恢复
-
-- 已知 `app_key` 时直接执行目标业务命令；只有应用名称时先用 `app list --query` 查找并核对 `app_name/title`，目标明确且唯一时取其 `app_key`，否则请用户确认。不能把名称传给 `--app-key`。只有业务命令明确报告会话或工作区错误后才恢复认证上下文。
-- 定位目标记录时先 query，再按需 get。字段只使用当前 schema 与字段能力允许的 id、能力和形状。
-- insert、update、delete 会改变真实业务数据。删除、覆盖已有值或批量写入前，必须确认目标和影响范围。
-- 返回后先检查 `write_executed`、`retry_safe`、字段错误和 hints。已执行、部分成功或状态不明时不得重放原请求。
-- data 命令失败时只修正响应明确指出的问题，不得切换其他数据入口绕过权限或校验。
-
-## 任务分流
-
-- 批量导入：阅读 [批量导入 SOP](../record/QINGFLOW_CLI_RECORD_IMPORT_WORKFLOW.md)。
-- 统计分析：阅读 [数据分析说明](../record/analysis/README.md)，使用 `data query --all --output csv` 并读取全部 CSV 分片。
-- 待办和流程动作：阅读 [任务上下文 SOP](../task/QINGFLOW_CLI_TASK_CONTEXT_WORKFLOW.md)。

package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_SPECIALIZED_WORKFLOW.md

@@ -1,50 +0,0 @@
-# Qingflow CLI：record 日志与附件参考
-
-> **适用范围**：任务需要完整数据／流程日志、附件或图片上下文时使用。普通应用数据查询使用 [`data query/get`](../core/QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md)。
-
-## record 查询链
-
-```text
-app get（解析 accessible_views，选定 VIEW_ID）
-  → record schema browse（读取该视图字段口径）
-  → record list（样本浏览或模糊定位候选）
-  → record get（可选：详情页首屏、附件与图片上下文）
-  → record logs（可选：完整数据日志与流程日志）
-```
-
-## 命令形状
-
-```bash
-qingflow --json app get --app-key APP_KEY > tmp/qingflow_app_get.json
-
-qingflow --json record schema browse \
-  --app-key APP_KEY --view-id VIEW_ID \
-  > tmp/qingflow_record_schema.json
-
-qingflow --json record list \
-  --app-key APP_KEY --view-id VIEW_ID \
-  > tmp/qingflow_record_list.json
-
-qingflow --json record get \
-  --app-key APP_KEY --record-id RECORD_ID --view-id VIEW_ID \
-  > tmp/qingflow_record_get.json
-
-qingflow --json record logs \
-  --app-key APP_KEY --record-id RECORD_ID --view-id VIEW_ID \
-  > tmp/qingflow_record_logs.json
-```
-
-`VIEW_ID` 只能来自 `app get.accessible_views`、已经确认的前端 URL 或用户明确提供的上下文。显式视图失败时不要自动换成另一系统视图。
-
-## 专有结果
-
-- `record get`：用于详情页字段、首屏日志、引用、关联资源、`media_assets` 和 `file_assets`。附件与图片优先使用返回的本地路径，不直接访问远端附件 URL。
-- `record logs`：用于完整可见数据日志和流程日志。响应只读取摘要与 JSONL 文件路径，按需筛选本地文件，不把全文放入上下文。
-- `record list`：只在用户明确指定该命令时用于样本浏览／模糊定位，不用于完整统计结论。
-
-## 边界
-
-- 统计分析仍转 `data query --all --output csv -> Python/pandas`。
-- `CUSTOM_VIEW_LIST_UNAVAILABLE` 只说明自定义视图列表读取受限；不要据此断言应用整体不可读。
-- 待办、已办和抄送属于 `task list --task-box ...`，不使用 `record list --view-id system:todo/done/cc`。
-- 所有大 JSON、附件清单和日志摘要必须落盘。

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/rich_text.json

@@ -1,146 +0,0 @@
-{
-  "$defs": {
-    "EmptyConfig": {
-      "additionalProperties": false,
-      "description": "该字段类型没有特殊配置。",
-      "type": "object"
-    },
-    "FieldCommon": {
-      "allOf": [
-        {
-          "if": {
-            "properties": {
-              "defaultType": {
-                "const": 2
-              }
-            },
-            "required": [
-              "defaultType"
-            ]
-          },
-          "then": {
-            "properties": {
-              "defaultValue": {
-                "type": "null"
-              }
-            }
-          }
-        },
-        {
-          "if": {
-            "properties": {
-              "defaultType": {
-                "const": 3
-              }
-            },
-            "required": [
-              "defaultType"
-            ]
-          },
-          "then": {
-            "properties": {
-              "defaultValue": {
-                "minLength": 1,
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            }
-          }
-        }
-      ],
-      "anyOf": [
-        {
-          "required": [
-            "queId"
-          ]
-        },
-        {
-          "required": [
-            "name"
-          ]
-        }
-      ],
-      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
-      "properties": {
-        "beingRequired": {
-          "description": "该字段是否必填;缺失时保留已有字段当前值。",
-          "type": "boolean"
-        },
-        "defaultType": {
-          "default": 1,
-          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
-          "enum": [
-            1,
-            2,
-            3
-          ],
-          "type": "integer"
-        },
-        "defaultValue": {
-          "$ref": "#/$defs/ScalarDefaultValue",
-          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
-        },
-        "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
-          "minLength": 1,
-          "type": "string"
-        },
-        "queId": {
-          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
-          "minimum": 1,
-          "type": "integer"
-        },
-        "questionDescription": {
-          "description": "字段说明;null 或空字符串表示清空。",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "questionType": {
-          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
-          "type": "string"
-        },
-        "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
-      "type": [
-        "null",
-        "string"
-      ]
-    }
-  },
-  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/rich_text.json",
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "allOf": [
-    {
-      "$ref": "#/$defs/FieldCommon"
-    },
-    {
-      "properties": {
-        "config": {
-          "$ref": "#/$defs/EmptyConfig"
-        },
-        "questionType": {
-          "const": "rich_text"
-        }
-      },
-      "required": [
-        "questionType"
-      ]
-    }
-  ],
-  "title": "Qingflow AppForm v1alpha1 rich_text field",
-  "type": "object",
-  "unevaluatedProperties": false
-}

package/src/qingflow_mcp/cli/commands/data.py

@@ -1,134 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import textwrap
-
-from ..context import CliContext
-from .common import load_list_arg, require_list_arg, require_object_arg, raise_config_error
-
-
-def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
-    parser = subparsers.add_parser(
-        "data",
-        help="默认应用数据查询与直接增删改",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog=textwrap.dedent("""
-            JSON 文件约定：
-              columns.json  [101, 102]
-              where.json    [{"field_id": 101, "op": "eq", "value": "A"}]
-              sort.json     [{"field_id": 101, "direction": "asc"}]
-              items.json    [{"fields": {"101": "A"}}]
-              fields.json   {"101": "B"}
-            query/get/insert/update 默认返回 field_capabilities；可用 --no-schema 关闭。
-        """).strip(),
-    )
-    commands = parser.add_subparsers(dest="data_command", required=True, metavar="{query,get,insert,update,delete}")
-
-    query = commands.add_parser(
-        "query", help="分页查询应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog='最小示例：qingflow data query --app-key APP_1 --where-file where.json\n'
-               'where.json: [{"field_id": 101, "op": "eq", "value": "A"}]',
-    )
-    query.add_argument("--app-key", required=True)
-    query.add_argument("--columns-file", help='JSON 数组，例如 [101, 102]')
-    query.add_argument(
-        "--where-file",
-        help='JSON 数组；项为 {"field_id":101,"op":"eq","value":"A"}，in/not_in 的 value 必须为数组',
-    )
-    query.add_argument("--sort-file", help='JSON 数组，例如 [{"field_id":101,"direction":"asc"}]')
-    query.add_argument("--search", default="")
-    query.add_argument("--page", type=int, default=1)
-    query.add_argument("--page-size", type=int, default=100)
-    query.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    query.add_argument("--all", action="store_true", dest="all_pages")
-    query.add_argument("--output", choices=("json", "csv"), default="json")
-    query.set_defaults(handler=_handle_query, format_hint="data_query")
-
-    get = commands.add_parser("get", help="读取单条应用数据")
-    get.add_argument("--app-key", required=True)
-    get.add_argument("--record-id", required=True)
-    get.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    get.set_defaults(handler=_handle_get, format_hint="data_get")
-
-    insert = commands.add_parser(
-        "insert", help="新增应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog='最小示例：items.json = [{"fields": {"101": "A"}}]',
-    )
-    insert.add_argument("--app-key", required=True)
-    insert.add_argument("--items-file", required=True, help='JSON 数组，项为 {"fields":{"字段ID":值}}')
-    insert.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    insert.set_defaults(handler=_handle_insert, format_hint="data_insert")
-
-    update = commands.add_parser(
-        "update", help="更新应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog='最小示例：fields.json = {"101": "B"}',
-    )
-    update.add_argument("--app-key", required=True)
-    update.add_argument("--record-id", required=True)
-    update.add_argument("--fields-file", required=True, help='JSON 对象，键为字符串形式 field_id')
-    update.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    update.set_defaults(handler=_handle_update, format_hint="data_update")
-
-    delete = commands.add_parser("delete", help="删除应用数据")
-    delete.add_argument("--app-key", required=True)
-    delete.add_argument(
-        "--record-ids", action="append", default=[], metavar="ID[,ID...]",
-        help="待删除记录 ID；支持逗号分隔，也可重复传入",
-    )
-    delete.add_argument("--record-ids-file", help="附加的记录 ID JSON 数组文件")
-    delete.set_defaults(handler=_handle_delete, format_hint="data_delete")
-
-
-def _handle_query(args: argparse.Namespace, context: CliContext) -> dict:
-    if args.all_pages != (args.output == "csv"):
-        raise_config_error(
-            "--all 与 --output csv 必须同时使用。",
-            fix_hint="使用 `qingflow data query ... --all --output csv`，普通分页查询不要传这两个参数。",
-        )
-    return context.data.data_query(
-        profile=args.profile,
-        app_key=args.app_key,
-        columns=load_list_arg(args.columns_file, option_name="--columns-file"),
-        where=load_list_arg(args.where_file, option_name="--where-file"),
-        sort=load_list_arg(args.sort_file, option_name="--sort-file"),
-        search=args.search,
-        page=args.page,
-        page_size=args.page_size,
-        include_schema=args.include_schema,
-        all_pages=args.all_pages,
-        output=args.output,
-    )
-
-
-def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.data.data_get(
-        profile=args.profile, app_key=args.app_key, record_id=args.record_id, include_schema=args.include_schema
-    )
-
-
-def _handle_insert(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.data.data_insert(
-        profile=args.profile, app_key=args.app_key,
-        items=require_list_arg(args.items_file, option_name="--items-file"), include_schema=args.include_schema,
-    )
-
-
-def _handle_update(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.data.data_update(
-        profile=args.profile, app_key=args.app_key, record_id=args.record_id,
-        fields=require_object_arg(args.fields_file, option_name="--fields-file"), include_schema=args.include_schema,
-    )
-
-
-def _handle_delete(args: argparse.Namespace, context: CliContext) -> dict:
-    record_ids = [item.strip() for group in args.record_ids for item in group.split(",") if item.strip()]
-    record_ids.extend(load_list_arg(args.record_ids_file, option_name="--record-ids-file"))
-    if not record_ids:
-        raise_config_error(
-            "至少传入一个记录 ID。",
-            fix_hint="使用 `--record-ids ID[,ID...]`；也可附加 `--record-ids-file ids.json`。",
-        )
-    return context.data.data_delete(
-        profile=args.profile, app_key=args.app_key,
-        record_ids=record_ids,
-    )

package/src/qingflow_mcp/tools/csv_export.py

@@ -1,168 +0,0 @@
-from __future__ import annotations
-
-import csv
-import json
-import time
-from pathlib import Path
-from typing import Any, Callable
-
-from ..json_types import JSONObject
-
-
-PageFetcher = Callable[[int, int], JSONObject]
-RowProjector = Callable[[JSONObject], list[str]]
-
-
-class CsvPageFailure(RuntimeError):
-    """后续分页返回结构化业务错误；已写文件保留为不完整结果。"""
-
-    def __init__(self, payload: JSONObject) -> None:
-        super().__init__(str(payload.get("message") or "分页请求失败"))
-        self.payload = payload
-
-
-class CsvShardWriter:
-    """视图无关的 UTF-8 BOM CSV 分片写入器。"""
-
-    def __init__(self, *, output_dir: Path, file_prefix: str, header: list[str], shard_rows: int) -> None:
-        self.output_dir = output_dir
-        self.file_prefix = file_prefix
-        self.header = header
-        self.shard_rows = shard_rows
-        self.files: list[JSONObject] = []
-        self.row_count = 0
-        self._part = 0
-        self._current_rows = 0
-        self._file: Any | None = None
-        self._writer: Any | None = None
-        output_dir.mkdir(parents=True, exist_ok=True)
-
-    def write(self, values: list[str]) -> None:
-        if self._current_rows >= self.shard_rows:
-            self.close_shard()
-        self._ensure_writer().writerow(values)
-        self._current_rows += 1
-        self.row_count += 1
-
-    def close_shard(self) -> None:
-        if self._file is None:
-            return
-        path = Path(self._file.name)
-        self._file.close()
-        self.files.append({"local_path": str(path), "row_count": self._current_rows, "part": len(self.files) + 1})
-        self._file = None
-        self._writer = None
-        self._current_rows = 0
-
-    def _ensure_writer(self) -> Any:
-        if self._writer is not None:
-            return self._writer
-        self._part += 1
-        path = self.output_dir / f"{self.file_prefix}-{self._part:04d}.csv"
-        self._file = path.open("w", newline="", encoding="utf-8-sig")
-        self._writer = csv.writer(self._file)
-        self._writer.writerow(self.header)
-        return self._writer
-
-
-def export_csv_pages(
-    *,
-    fetch_page: PageFetcher,
-    header: list[str],
-    project_row: RowProjector,
-    output_dir: Path,
-    file_prefix: str,
-    page_size: int,
-    shard_rows: int,
-    time_budget_seconds: float,
-) -> JSONObject:
-    """执行与业务权限无关的分页、CSV 分片和时间预算控制。"""
-    output_dir.mkdir(parents=True, exist_ok=True)
-    deadline = time.monotonic() + time_budget_seconds
-    files: list[JSONObject] = []
-    row_count = 0
-    fetched_pages = 0
-    current_page = 1
-    file_handle: Any | None = None
-    writer: Any | None = None
-    current_rows = 0
-    part = 0
-    has_more = False
-    stopped_reason: str | None = None
-    page_error: JSONObject | None = None
-
-    def close_file() -> None:
-        nonlocal file_handle, writer, current_rows
-        if file_handle is None:
-            return
-        path = Path(file_handle.name)
-        file_handle.close()
-        files.append({"local_path": str(path), "row_count": current_rows, "part": len(files) + 1})
-        file_handle = None
-        writer = None
-        current_rows = 0
-
-    def get_writer() -> Any:
-        nonlocal file_handle, writer, part
-        if writer is not None:
-            return writer
-        part += 1
-        path = output_dir / f"{file_prefix}-{part:04d}.csv"
-        file_handle = path.open("w", newline="", encoding="utf-8-sig")
-        writer = csv.writer(file_handle)
-        writer.writerow(header)
-        return writer
-
-    try:
-        while True:
-            page = fetch_page(current_page, page_size)
-            records = page.get("records") if isinstance(page, dict) else None
-            container = records if isinstance(records, dict) else page
-            raw_items = container.get("items", container.get("list", [])) if isinstance(container, dict) else []
-            items = raw_items if isinstance(raw_items, list) else []
-            has_more = bool(container.get("has_more")) if isinstance(container, dict) else False
-            for item in items:
-                if not isinstance(item, dict):
-                    continue
-                if current_rows >= shard_rows:
-                    close_file()
-                get_writer().writerow(project_row(item))
-                current_rows += 1
-                row_count += 1
-            fetched_pages += 1
-            if not has_more:
-                break
-            if time.monotonic() >= deadline:
-                stopped_reason = "TIME_BUDGET_EXCEEDED"
-                break
-            current_page += 1
-    except CsvPageFailure as exception:
-        stopped_reason = "PAGE_FETCH_FAILED"
-        page_error = exception.payload
-    except Exception:
-        # 已落盘分片仍是有效的部分结果；调用方据此禁止形成完整性结论。
-        stopped_reason = "PAGE_FETCH_FAILED"
-    finally:
-        close_file()
-
-    complete = stopped_reason is None and not has_more
-    result: JSONObject = {
-        "files": files,
-        "row_count": row_count,
-        "complete": complete,
-        "truncated": not complete,
-        "safe_for_final_conclusion": complete,
-        "fetched_pages": fetched_pages,
-        "stopped_reason": stopped_reason,
-    }
-    if page_error is not None:
-        result["page_error"] = page_error
-    return result
-
-
-def csv_cell(value: Any) -> str:
-    if value is None:
-        return ""
-    if isinstance(value, (dict, list)):
-        return json.dumps(value, ensure_ascii=False, separators=(",", ":"))
-    return str(value)