@cueai/omni-reader-mcp 1.5.4 → 1.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -48,7 +48,7 @@ agent workspace remains the default allowed scope.
48
48
  For a local file, Bridge requests a Cube parse grant and uses the returned controlled
49
49
  granted-data-plane URL to upload the file and stream the result. A `BRIDGE_UPGRADE_REQUIRED`
50
50
  error means the running Bridge release is not accepted for direct local-file parsing —
51
- install `@cueai/omni-reader-mcp@1.5.4` using the official setup instructions, then retry the
51
+ install `@cueai/omni-reader-mcp@1.5.5` using the official setup instructions, then retry the
52
52
  same parse. Always run `doctor --json` first when diagnosing a parse failure.
53
53
 
54
54
  ## Free credits
@@ -72,7 +72,7 @@ differ from the numbers above, report the live values.
72
72
  Always use an audited exact version, never an implicit `latest`:
73
73
 
74
74
  ```sh
75
- npx -y @cueai/omni-reader-mcp@1.5.4 setup
75
+ npx -y @cueai/omni-reader-mcp@1.5.5 setup
76
76
  ```
77
77
 
78
78
  The interactive setup supports Hermes, Cursor, Claude Desktop, and generic stdio
@@ -80,9 +80,9 @@ configuration. Non-interactive installation uses the same argument parsing and w
80
80
  logic:
81
81
 
82
82
  ```sh
83
- npx -y @cueai/omni-reader-mcp@1.5.4 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
84
- npx -y @cueai/omni-reader-mcp@1.5.4 setup --client cursor --add-root /absolute/minimum/root --yes --json
85
- npx -y @cueai/omni-reader-mcp@1.5.4 setup --client claude-desktop --allowed-root /absolute/minimum/root --yes --json
83
+ npx -y @cueai/omni-reader-mcp@1.5.5 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
84
+ npx -y @cueai/omni-reader-mcp@1.5.5 setup --client cursor --add-root /absolute/minimum/root --yes --json
85
+ npx -y @cueai/omni-reader-mcp@1.5.5 setup --client claude-desktop --allowed-root /absolute/minimum/root --yes --json
86
86
  ```
87
87
 
88
88
  When an agent or script runs under a pty (stdin is still a TTY), declare non-interactive
@@ -90,7 +90,7 @@ mode explicitly with `--headless` (alias `--non-interactive`): no `--yes` is req
90
90
  stdin is never read:
91
91
 
92
92
  ```sh
93
- npx -y @cueai/omni-reader-mcp@1.5.4 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
93
+ npx -y @cueai/omni-reader-mcp@1.5.5 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
94
94
  ```
95
95
 
96
96
  ## Windows configuration
@@ -109,14 +109,14 @@ automatically; the second is the most robust when you configure by hand.
109
109
  1. **`cmd` + `npx` (what `setup` writes on Windows)** — `cmd.exe` is a real executable,
110
110
  so a client's no-shell spawn works:
111
111
  ```json
112
- { "command": "cmd", "args": ["/d", "/c", "npx", "-y", "@cueai/omni-reader-mcp@1.5.4"] }
112
+ { "command": "cmd", "args": ["/d", "/c", "npx", "-y", "@cueai/omni-reader-mcp@1.5.5"] }
113
113
  ```
114
114
  2. **`node` + the package entry (most robust)** — skips `npx` entirely; the absolute
115
115
  path must be a stable install you control:
116
116
  ```json
117
117
  { "command": "node", "args": ["C:\\path\\to\\node_modules\\@cueai\\omni-reader-mcp\\dist\\index.js"] }
118
118
  ```
119
- A deliberate local `npm install @cueai/omni-reader-mcp@1.5.4` gives you that stable
119
+ A deliberate local `npm install @cueai/omni-reader-mcp@1.5.5` gives you that stable
120
120
  path. Do not point the entry at an `_npx` cache directory — its hash subdirectory
121
121
  changes between installs.
122
122
  3. **Never use a session/timestamp directory** — such paths are cleaned up, and the
@@ -261,16 +261,16 @@ satisfies the constraints.
261
261
  ## Commands
262
262
 
263
263
  ```sh
264
- npx -y @cueai/omni-reader-mcp@1.5.4 doctor
265
- npx -y @cueai/omni-reader-mcp@1.5.4 doctor --json
266
- npx -y @cueai/omni-reader-mcp@1.5.4 clean
267
- npx -y @cueai/omni-reader-mcp@1.5.4 uninstall --yes --json
264
+ npx -y @cueai/omni-reader-mcp@1.5.5 doctor
265
+ npx -y @cueai/omni-reader-mcp@1.5.5 doctor --json
266
+ npx -y @cueai/omni-reader-mcp@1.5.5 clean
267
+ npx -y @cueai/omni-reader-mcp@1.5.5 uninstall --yes --json
268
268
  ```
269
269
 
270
270
  Running the pinned version without a command starts the stdio MCP server:
271
271
 
272
272
  ```sh
273
- npx -y @cueai/omni-reader-mcp@1.5.4
273
+ npx -y @cueai/omni-reader-mcp@1.5.5
274
274
  ```
275
275
 
276
276
  `doctor --json` returns package/npm/client adapter, Key present/absent, allowed-root
@@ -283,15 +283,15 @@ definitively "available" until a real local-file parse validates the route.
283
283
 
284
284
  ## Network diagnostics
285
285
 
286
- Run `npx -y @cueai/omni-reader-mcp@1.5.4 doctor --json` first. Diagnose failures by
286
+ Run `npx -y @cueai/omni-reader-mcp@1.5.5 doctor --json` first. Diagnose failures by
287
287
  stage instead of guessing an endpoint:
288
288
 
289
- | Code | Stage | Meaning |
289
+ | Failure | Stage | Meaning |
290
290
  |---|---|---|
291
291
  | `CUBE_UNAVAILABLE` | before upload | the control plane could not create a parse grant |
292
292
  | `PRINCIPAL_CONCURRENCY_LIMIT` | before upload | the principal already has the maximum active parses; wait for `retry_after`, then retry the same parse |
293
- | `BRIDGE_UPGRADE_REQUIRED` | before upload | this Bridge release is too old; install `@cueai/omni-reader-mcp@1.5.4` via the official setup, then retry the same parse |
294
- | `IIIS_UNAVAILABLE` | after grant creation | the granted upload stage could not complete |
293
+ | `BRIDGE_UPGRADE_REQUIRED` | before upload | this Bridge release is too old; install `@cueai/omni-reader-mcp@1.5.5` via the official setup, then retry the same parse |
294
+ | a secure upload-stage failure | after grant creation | the file was granted, but the secure upload stage did not complete |
295
295
  | `CUBE_PROTOCOL_ERROR` | control-plane response | the response did not match the required contract |
296
296
  | `MCP error -32000: Connection closed` | before Bridge starts | the client launcher shape is invalid; see Windows configuration |
297
297
 
@@ -309,12 +309,12 @@ the same way from every client.
309
309
 
310
310
  ## Uninstall and rollback
311
311
 
312
- `uninstall --yes --json` removes only a trusted 1.5.3 or 1.5.4 Bridge entry, plus
312
+ `uninstall --yes --json` removes only a trusted 1.5.4 or 1.5.5 Bridge entry, plus
313
313
  the exact broken bare-`npx` Windows entry written by 1.5.1. When a matching trusted
314
314
  backup exists, it restores the original URL-only `omni-reader` entry. Uninstall never
315
315
  deletes user source files and never silently removes unexpired local results.
316
316
 
317
- To roll back from 1.5.4:
317
+ To roll back from 1.5.5:
318
318
 
319
319
  1. stop recommending or installing that version;
320
320
  2. run `uninstall --yes --json` to restore the trusted URL-only entry;
@@ -7,7 +7,7 @@ const PACKAGE_SPEC = `@cueai/omni-reader-mcp@${BRIDGE_RELEASE_VERSION}`;
7
7
  // The release that the current version is a trusted upgrade from: normal upgrade,
8
8
  // uninstall, and rollback recognize exactly {previous, current}. Bump this to the
9
9
  // version we just published when BRIDGE_RELEASE_VERSION advances.
10
- const PREVIOUS_RELEASE_VERSION = "1.5.3";
10
+ const PREVIOUS_RELEASE_VERSION = "1.5.4";
11
11
  const PREVIOUS_PACKAGE_SPEC = `@cueai/omni-reader-mcp@${PREVIOUS_RELEASE_VERSION}`;
12
12
  // Preserve the one evidenced two-release migration exception: 1.5.1 setup wrote a
13
13
  // bare `npx` launcher on Windows, so later setup/uninstall versions must still be able
@@ -641,7 +641,7 @@ export function expectedBridgeVersion(target, value, platform) {
641
641
  }
642
642
  function isLegacyBridgeEntry(target, value, platform) {
643
643
  // Defer the entire invocation-shape decision to the single platform policy:
644
- // exact pinned {1.5.3 previous, 1.5.4 current} plus the exact Windows 1.5.1
644
+ // exact pinned {1.5.4 previous, 1.5.5 current} plus the exact Windows 1.5.1
645
645
  // bare-npx migration source. The historical platform-agnostic acceptance of a
646
646
  // bare unpinned `npx -y @cueai/omni-reader-mcp` is removed: it widened the
647
647
  // frozen trust set to a floating latest on every OS, which expectedBridgeVersion
@@ -6,7 +6,7 @@ export declare const CUBE_GRANT_PROTOCOL_VERSION = "omni.parse_grant.v1";
6
6
  export declare const GRANTED_STREAM_PROTOCOL_VERSION = "omni.granted_parse_stream.v1";
7
7
  export declare const DEFAULT_CUBE_BASE_URL = "https://mcp.cuecue.cn";
8
8
  export declare const DEFAULT_IIIS_GRANTED_BASE_URL = "https://omni-upload.cuecue.cn/omni/granted/";
9
- export declare const BRIDGE_RELEASE_VERSION = "1.5.4";
9
+ export declare const BRIDGE_RELEASE_VERSION = "1.5.5";
10
10
  export declare const REMOTE_OMNI_MCP_URL = "https://mcp.cuecue.cn/api/omni-reader/mcp/";
11
11
  export declare const FOREGROUND_BUDGET_MS = 15000;
12
12
  export declare const STATUS_LONG_POLL_MAX_MS = 20000;
package/dist/constants.js CHANGED
@@ -6,7 +6,7 @@ export const CUBE_GRANT_PROTOCOL_VERSION = "omni.parse_grant.v1";
6
6
  export const GRANTED_STREAM_PROTOCOL_VERSION = "omni.granted_parse_stream.v1";
7
7
  export const DEFAULT_CUBE_BASE_URL = "https://mcp.cuecue.cn";
8
8
  export const DEFAULT_IIIS_GRANTED_BASE_URL = "https://omni-upload.cuecue.cn/omni/granted/";
9
- export const BRIDGE_RELEASE_VERSION = "1.5.4";
9
+ export const BRIDGE_RELEASE_VERSION = "1.5.5";
10
10
  export const REMOTE_OMNI_MCP_URL = "https://mcp.cuecue.cn/api/omni-reader/mcp/";
11
11
  export const FOREGROUND_BUDGET_MS = 15_000;
12
12
  export const STATUS_LONG_POLL_MAX_MS = 20_000;
@@ -185,7 +185,7 @@ async function grantResponseError(response) {
185
185
  if (bridgeUpgradeRequiredSchema.safeParse(body).success) {
186
186
  return bridgeError("BRIDGE_UPGRADE_REQUIRED", "This Bridge release is not accepted for direct local-file parsing.", false, {
187
187
  failureScope: "service",
188
- userAction: "Upgrade to @cueai/omni-reader-mcp@1.5.4 using the official Omni setup instructions, then retry the same local-file parse.",
188
+ userAction: `Upgrade to @cueai/omni-reader-mcp@${BRIDGE_RELEASE_VERSION} using the official Omni setup instructions, then retry the same local-file parse.`,
189
189
  });
190
190
  }
191
191
  }
package/package.json CHANGED
@@ -1,7 +1,20 @@
1
1
  {
2
2
  "name": "@cueai/omni-reader-mcp",
3
- "version": "1.5.4",
3
+ "version": "1.5.5",
4
4
  "description": "Local stdio MCP bridge for direct Omni document parsing",
5
+ "keywords": [
6
+ "mcp",
7
+ "model-context-protocol",
8
+ "omni-reader",
9
+ "document-parsing",
10
+ "pdf",
11
+ "ocr",
12
+ "url-parsing",
13
+ "local-files",
14
+ "audio",
15
+ "video",
16
+ "ai-agents"
17
+ ],
5
18
  "type": "module",
6
19
  "license": "UNLICENSED",
7
20
  "engines": {