@cueai/omni-reader-mcp 1.1.2 → 1.1.3

package/README.md

@@ -33,21 +33,21 @@ Bridge 运行时只使用以下产品配置：
 始终使用已审核的精确版本，不使用隐式 `latest`：
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.1.2 setup
+npx -y @cueai/omni-reader-mcp@1.1.3 setup
 ```
 
 交互 setup 支持 Hermes、Cursor、Claude Desktop 和通用 stdio 配置。非交互安装使用同一参数解析和写入逻辑：
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.1.2 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
-npx -y @cueai/omni-reader-mcp@1.1.2 setup --client cursor --add-root /absolute/minimum/root --yes --json
-npx -y @cueai/omni-reader-mcp@1.1.2 setup --client claude-desktop --allowed-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.1.3 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.1.3 setup --client cursor --add-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.1.3 setup --client claude-desktop --allowed-root /absolute/minimum/root --yes --json
 ```
 
 Agent/脚本在 pty 下运行（stdin 仍是 TTY）时，用 `--headless`（别名 `--non-interactive`）显式声明非交互，无需 `--yes` 且绝不读 stdin：
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.1.2 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
+npx -y @cueai/omni-reader-mcp@1.1.3 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
 ```
 
 ## 缓存与 journal 隔离
@@ -89,7 +89,14 @@ Agent 将用户提供的来源字符串直接传给 `parse(source)`：
 - `read_result`
 - `discard_result`
 
-每个工具都返回 `structuredContent` 和严格 `outputSchema`。
+每个工具都返回 `structuredContent` 和严格 `outputSchema`，同时为只读取传统 MCP `content[].text` 的客户端提供等价回退：
+
+- `parse` 完成且结果可 inline 时，text 直接返回完整 Markdown；
+- processing、artifact、cleanup、cancel、expired 和 failure 状态，text 返回与 `structuredContent` 字段等价的紧凑 JSON；
+- `read_result` 的 text JSON 包含本次 `result.text` 和可选 `next_cursor`，客户端必须追完所有 cursor 后再拼接正文；
+- `discard_result` 的 text JSON 明确返回 `discarded`，不得仅凭调用成功宣称结果已删除。
+
+这使不展示 `structuredContent` 的客户端也能取得 operation/result 句柄和完整正文，同时不改变支持结构化结果的客户端契约。
 
 ## 前台、后台和进度
 
@@ -128,23 +135,23 @@ Agent 不应自动拆分、转码或上传公共站点；应请用户提供符
 ## 命令
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.1.2 doctor
-npx -y @cueai/omni-reader-mcp@1.1.2 doctor --json
-npx -y @cueai/omni-reader-mcp@1.1.2 clean
-npx -y @cueai/omni-reader-mcp@1.1.2 uninstall --yes --json
+npx -y @cueai/omni-reader-mcp@1.1.3 doctor
+npx -y @cueai/omni-reader-mcp@1.1.3 doctor --json
+npx -y @cueai/omni-reader-mcp@1.1.3 clean
+npx -y @cueai/omni-reader-mcp@1.1.3 uninstall --yes --json
 ```
 
 不带命令运行固定版本会启动 stdio MCP server：
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.1.2
+npx -y @cueai/omni-reader-mcp@1.1.3
 ```
 
 `doctor --json` 返回 package/npm/client adapter、Key present/absent、allowed-root 安全状态、endpoint compatibility、artifact、cache mode、onboarding 和 reload 状态；不会输出 Key、私有来源路径或内容。
 
 ## 卸载与回滚
 
-`uninstall --yes --json` 只删除当前受信的 1.1.2 Bridge entry；存在匹配的可信备份时恢复原 URL-only `omni-reader` entry。卸载不会删除用户源文件，也不会静默删除未过期的本地结果。
+`uninstall --yes --json` 只删除当前受信的 1.1.3 Bridge entry；存在匹配的可信备份时恢复原 URL-only `omni-reader` entry。卸载不会删除用户源文件，也不会静默删除未过期的本地结果。
 
 需要回滚 1.1.1 时：
 

package/dist/constants.d.ts

@@ -6,7 +6,7 @@ export declare const CUBE_GRANT_PROTOCOL_VERSION = "omni.parse_grant.v1";
 export declare const GRANTED_STREAM_PROTOCOL_VERSION = "omni.granted_parse_stream.v1";
 export declare const DEFAULT_CUBE_BASE_URL = "https://mcp.cuecue.cn";
 export declare const DEFAULT_IIIS_GRANTED_BASE_URL = "https://cubefile.ai.iiis.co:9443/omni/granted/";
-export declare const BRIDGE_RELEASE_VERSION = "1.1.2";
+export declare const BRIDGE_RELEASE_VERSION = "1.1.3";
 export declare const REMOTE_OMNI_MCP_URL = "https://mcp.cuecue.cn/api/omni-reader/mcp/";
 export declare const FOREGROUND_BUDGET_MS = 15000;
 export declare const STATUS_LONG_POLL_MAX_MS = 20000;

package/dist/constants.js

@@ -6,7 +6,7 @@ export const CUBE_GRANT_PROTOCOL_VERSION = "omni.parse_grant.v1";
 export const GRANTED_STREAM_PROTOCOL_VERSION = "omni.granted_parse_stream.v1";
 export const DEFAULT_CUBE_BASE_URL = "https://mcp.cuecue.cn";
 export const DEFAULT_IIIS_GRANTED_BASE_URL = "https://cubefile.ai.iiis.co:9443/omni/granted/";
-export const BRIDGE_RELEASE_VERSION = "1.1.2";
+export const BRIDGE_RELEASE_VERSION = "1.1.3";
 export const REMOTE_OMNI_MCP_URL = "https://mcp.cuecue.cn/api/omni-reader/mcp/";
 export const FOREGROUND_BUDGET_MS = 15_000;
 export const STATUS_LONG_POLL_MAX_MS = 20_000;

package/dist/result-contract.js

@@ -210,26 +210,24 @@ export const discardResultToolOutputSchema = z
     error: stableErrorSchema.optional(),
 })
     .strict();
-function summarizeForTextFallback(value) {
-    if (value.status === "failed") {
-        const error = value.error;
-        return `Omni failed: ${typeof error?.code === "string" ? error.code : "UNKNOWN"}.`;
+function textFallback(value) {
+    if (value.status === "completed") {
+        const result = value.result;
+        if (result !== null
+            && typeof result === "object"
+            && !Array.isArray(result)
+            && result.kind === "inline"
+            && typeof result.text === "string") {
+            return result.text;
+        }
     }
-    if (value.status === "processing")
-        return "Omni processing.";
-    if (value.status === "cleanup_pending")
-        return "Omni cleanup pending.";
-    if (value.status === "canceled")
-        return "Omni canceled.";
-    if (value.status === "expired")
-        return "Omni result expired.";
-    return "Omni completed.";
+    return JSON.stringify(value);
 }
 export function structuredResult(schema, value) {
     const structuredContent = schema.parse(value);
     return {
         ...(structuredContent.status === "failed" ? { isError: true } : {}),
         structuredContent,
-        content: [{ type: "text", text: summarizeForTextFallback(structuredContent) }],
+        content: [{ type: "text", text: textFallback(structuredContent) }],
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueai/omni-reader-mcp",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Local stdio MCP bridge for direct Omni document parsing",
   "type": "module",
   "license": "UNLICENSED",