@cueai/omni-reader-mcp 1.4.0 → 1.4.1

package/README.md

@@ -64,7 +64,7 @@ differ from the numbers above, report the live values.
 Always use an audited exact version, never an implicit `latest`:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.4.0 setup
+npx -y @cueai/omni-reader-mcp@1.4.1 setup
 ```
 
 The interactive setup supports Hermes, Cursor, Claude Desktop, and generic stdio
@@ -72,9 +72,9 @@ configuration. Non-interactive installation uses the same argument parsing and w
 logic:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.4.0 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
-npx -y @cueai/omni-reader-mcp@1.4.0 setup --client cursor --add-root /absolute/minimum/root --yes --json
-npx -y @cueai/omni-reader-mcp@1.4.0 setup --client claude-desktop --allowed-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.4.1 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.4.1 setup --client cursor --add-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.4.1 setup --client claude-desktop --allowed-root /absolute/minimum/root --yes --json
 ```
 
 When an agent or script runs under a pty (stdin is still a TTY), declare non-interactive
@@ -82,7 +82,7 @@ mode explicitly with `--headless` (alias `--non-interactive`): no `--yes` is req
 stdin is never read:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.4.0 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
+npx -y @cueai/omni-reader-mcp@1.4.1 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
 ```
 
 ## Cache and journal isolation
@@ -133,6 +133,7 @@ The public tools are fixed:
 - `read_result`
 - `read_outline`
 - `discard_result`
+- `save_result`
 
 Every tool returns `structuredContent` with a strict `outputSchema`, plus an equivalent
 fallback for clients that only read legacy MCP `content[].text`:
@@ -150,7 +151,11 @@ fallback for clients that only read legacy MCP `content[].text`:
   advancing sequentially through `next_cursor`. An empty or absent outline is reported
   explicitly, never silently — it never blocks reading the result itself with `read_result`;
 - the `discard_result` text JSON explicitly returns `discarded`; never claim deletion on
-  call success alone.
+  call success alone;
+- the `save_result` text JSON contains the written file `path` and `bytes` count; there is
+  no path argument — the file is always named from `result_id` inside the Bridge cache's
+  export directory, so it cannot be pointed at an arbitrary location; calling it again for
+  the same result overwrites the same file.
 
 This gives clients that do not render `structuredContent` the operation/result handles
 and the full body without changing the contract for structured-capable clients.
@@ -188,7 +193,11 @@ Both URL and local files use mandatory no-store semantics and enter the
   **24 hours**; this is a different class of data from the remote 10-minute delivery
   window;
 - `read_result` reads local results in chunks; `discard_result` deletes a specific result
-  immediately; `clean` removes Bridge-created local artifacts and expired records.
+  immediately; `clean` removes Bridge-created local artifacts and expired records;
+- `save_result` writes a result's complete content to a stable file under the Bridge cache's
+  export directory and returns its path; exports are independent of the 24-hour cache sweep,
+  so discarding the cached artifact or letting retention expire does not remove an export the
+  user asked to keep.
 
 Status queries, result reads, and discards never create a new parse or usage event.
 `cancel_parse` reports only the real settlement state confirmed by the server and never
@@ -212,16 +221,16 @@ satisfies the constraints.
 ## Commands
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.4.0 doctor
-npx -y @cueai/omni-reader-mcp@1.4.0 doctor --json
-npx -y @cueai/omni-reader-mcp@1.4.0 clean
-npx -y @cueai/omni-reader-mcp@1.4.0 uninstall --yes --json
+npx -y @cueai/omni-reader-mcp@1.4.1 doctor
+npx -y @cueai/omni-reader-mcp@1.4.1 doctor --json
+npx -y @cueai/omni-reader-mcp@1.4.1 clean
+npx -y @cueai/omni-reader-mcp@1.4.1 uninstall --yes --json
 ```
 
 Running the pinned version without a command starts the stdio MCP server:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.4.0
+npx -y @cueai/omni-reader-mcp@1.4.1
 ```
 
 `doctor --json` returns package/npm/client adapter, Key present/absent, allowed-root
@@ -230,12 +239,12 @@ status; it never prints the Key, private source paths, or content.
 
 ## Uninstall and rollback
 
-`uninstall --yes --json` removes only a trusted 1.3.3 or 1.4.0 Bridge entry; when a
+`uninstall --yes --json` removes only a trusted 1.4.0 or 1.4.1 Bridge entry; when a
 matching trusted backup exists, it restores the original URL-only `omni-reader` entry.
 Uninstall never deletes user source files and never silently removes unexpired local
 results.
 
-To roll back from 1.4.0:
+To roll back from 1.4.1:
 
 1. stop recommending or installing that version;
 2. run `uninstall --yes --json` to restore the trusted URL-only entry;

package/dist/cli/agent-config.js

@@ -7,7 +7,7 @@ const PACKAGE_SPEC = `@cueai/omni-reader-mcp@${BRIDGE_RELEASE_VERSION}`;
 // The release that the current version is a trusted upgrade from: uninstall and
 // rollback recognize exactly {previous, current} and nothing else. Bump this to
 // the version we just published when BRIDGE_RELEASE_VERSION advances.
-const PREVIOUS_RELEASE_VERSION = "1.3.3";
+const PREVIOUS_RELEASE_VERSION = "1.4.0";
 const PREVIOUS_PACKAGE_SPEC = `@cueai/omni-reader-mcp@${PREVIOUS_RELEASE_VERSION}`;
 const LEGACY_PACKAGE_SPEC = "@cueai/omni-reader-mcp";
 const TRUSTED_EXACT_PACKAGE_SPECS = new Set([PREVIOUS_PACKAGE_SPEC, PACKAGE_SPEC]);

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.4.0";
+export declare const BRIDGE_RELEASE_VERSION = "1.4.1";
 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.4.0";
+export const BRIDGE_RELEASE_VERSION = "1.4.1";
 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/package.json

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