@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 +19 -19
- package/dist/cli/agent-config.js +2 -2
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/cube-client.js +1 -1
- package/package.json +14 -1
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.
|
|
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.
|
|
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.
|
|
84
|
-
npx -y @cueai/omni-reader-mcp@1.5.
|
|
85
|
-
npx -y @cueai/omni-reader-mcp@1.5.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
265
|
-
npx -y @cueai/omni-reader-mcp@1.5.
|
|
266
|
-
npx -y @cueai/omni-reader-mcp@1.5.
|
|
267
|
-
npx -y @cueai/omni-reader-mcp@1.5.
|
|
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.
|
|
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.
|
|
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
|
-
|
|
|
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.
|
|
294
|
-
|
|
|
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.
|
|
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.
|
|
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;
|
package/dist/cli/agent-config.js
CHANGED
|
@@ -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.
|
|
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.
|
|
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
|
package/dist/constants.d.ts
CHANGED
|
@@ -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.
|
|
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.
|
|
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;
|
package/dist/cube-client.js
CHANGED
|
@@ -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:
|
|
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.
|
|
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": {
|