@cueai/omni-reader-mcp 1.2.0 → 1.2.1

package/README.md

@@ -23,9 +23,10 @@ summarization, Q&A, field extraction — rather than stopping at "parse done".
 ## Requirements
 
 - Node.js 20.12 or newer.
-- Cue API Key: <https://cuecue.cn/api-key>.
-- New accounts receive free credits to try; the current grant and daily allowance follow
-  the server-side onboarding policy and the `doctor` output.
+- Cue API Key: <https://cuecue.cn/hub/api-key>.
+- New accounts can try Omni without paying; see [Free credits](#free-credits) below. The
+  server-side onboarding policy and the `doctor` output are the live authority for current
+  allowances.
 - Configure `CUE_API_KEY` in the agent's secret store or local environment.
   **Never paste the API Key into a conversation.**
 
@@ -38,12 +39,28 @@ Bridge reads only these product configuration variables at runtime:
 authorizes; colon-separated on macOS/Linux, semicolon-separated on Windows. The current
 agent workspace remains the default allowed scope.
 
+## Free credits
+
+As of 2026-08-14:
+
+- every account receives 10 free credits daily — roughly 150 pages of ordinary documents,
+  75 pages of scanned images or charts, 30 minutes of audio, or 4 minutes of video;
+- new accounts receive a one-time 50-credit gift when obtaining `CUE_API_KEY` (60 credits
+  available on day one, including the daily grant);
+- inviting a new user who registers gives both the inviter and the invitee 50 credits, with
+  no invite limit; when an invited user subscribes, the inviter additionally receives 10% of
+  the invitee's first-month credit quota as a bonus.
+
+When available, the `doctor` output reports the live first-registration gift and daily grant;
+referral rules and conversion ratios follow the server-side onboarding policy. If live values
+differ from the numbers above, report the live values.
+
 ## Installation and configuration
 
 Always use an audited exact version, never an implicit `latest`:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.2.0 setup
+npx -y @cueai/omni-reader-mcp@1.2.1 setup
 ```
 
 The interactive setup supports Hermes, Cursor, Claude Desktop, and generic stdio
@@ -51,9 +68,9 @@ configuration. Non-interactive installation uses the same argument parsing and w
 logic:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.2.0 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
-npx -y @cueai/omni-reader-mcp@1.2.0 setup --client cursor --add-root /absolute/minimum/root --yes --json
-npx -y @cueai/omni-reader-mcp@1.2.0 setup --client claude-desktop --allowed-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.2.1 setup --client hermes --allowed-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.2.1 setup --client cursor --add-root /absolute/minimum/root --yes --json
+npx -y @cueai/omni-reader-mcp@1.2.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
@@ -61,7 +78,7 @@ mode explicitly with `--headless` (alias `--non-interactive`): no `--yes` is req
 stdin is never read:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.2.0 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
+npx -y @cueai/omni-reader-mcp@1.2.1 setup --client cursor --allowed-root /absolute/minimum/root --headless --json
 ```
 
 ## Cache and journal isolation
@@ -181,16 +198,16 @@ new source that satisfies the constraints.
 ## Commands
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.2.0 doctor
-npx -y @cueai/omni-reader-mcp@1.2.0 doctor --json
-npx -y @cueai/omni-reader-mcp@1.2.0 clean
-npx -y @cueai/omni-reader-mcp@1.2.0 uninstall --yes --json
+npx -y @cueai/omni-reader-mcp@1.2.1 doctor
+npx -y @cueai/omni-reader-mcp@1.2.1 doctor --json
+npx -y @cueai/omni-reader-mcp@1.2.1 clean
+npx -y @cueai/omni-reader-mcp@1.2.1 uninstall --yes --json
 ```
 
 Running the pinned version without a command starts the stdio MCP server:
 
 ```sh
-npx -y @cueai/omni-reader-mcp@1.2.0
+npx -y @cueai/omni-reader-mcp@1.2.1
 ```
 
 `doctor --json` returns package/npm/client adapter, Key present/absent, allowed-root
@@ -199,7 +216,7 @@ status; it never prints the Key, private source paths, or content.
 
 ## Uninstall and rollback
 
-`uninstall --yes --json` removes only the currently trusted 1.2.0 Bridge entry; when a
+`uninstall --yes --json` removes only the currently trusted 1.2.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.

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.2.0";
+export declare const BRIDGE_RELEASE_VERSION = "1.2.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.2.0";
+export const BRIDGE_RELEASE_VERSION = "1.2.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/dist/onboarding-policy.d.ts

@@ -1,10 +1,13 @@
 export declare const ONBOARDING_POLICY_URL = "https://cuecue.cn/api/v1/billing/public/onboarding-policy";
-export declare const API_KEY_URL = "https://cuecue.cn/api-key";
+export declare const API_KEY_URL = "https://cuecue.cn/hub/api-key";
+export declare const LEGACY_API_KEY_URL = "https://cuecue.cn/api-key";
+type ApiKeyUrl = typeof API_KEY_URL | typeof LEGACY_API_KEY_URL;
 export interface OnboardingPolicy {
-    readonly apiKeyUrl: typeof API_KEY_URL;
+    readonly apiKeyUrl: ApiKeyUrl;
     readonly firstRegistrationCredits: number;
     readonly freeDailyCredits: number;
 }
 export declare function getOnboardingPolicy(fetchImpl: typeof fetch, signal: AbortSignal): Promise<OnboardingPolicy | undefined>;
 export declare function onboardingGuidance(policy: OnboardingPolicy | undefined): string;
 export declare function getOnboardingPolicyWithTimeout(fetchImpl: typeof fetch, timeoutMs?: number): Promise<OnboardingPolicy | undefined>;
+export {};

package/dist/onboarding-policy.js

@@ -1,5 +1,6 @@
 export const ONBOARDING_POLICY_URL = "https://cuecue.cn/api/v1/billing/public/onboarding-policy";
-export const API_KEY_URL = "https://cuecue.cn/api-key";
+export const API_KEY_URL = "https://cuecue.cn/hub/api-key";
+export const LEGACY_API_KEY_URL = "https://cuecue.cn/api-key";
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -9,12 +10,16 @@ function boundedCredits(value) {
 function normalizeOnboardingPolicy(value) {
     if (!isRecord(value))
         return undefined;
-    if (value.api_key_url !== API_KEY_URL ||
+    const apiKeyUrl = value.api_key_url;
+    const accepted = apiKeyUrl === API_KEY_URL || apiKeyUrl === LEGACY_API_KEY_URL;
+    if (!accepted ||
         !boundedCredits(value.first_registration) ||
         !boundedCredits(value.free_daily))
         return undefined;
     return {
-        apiKeyUrl: API_KEY_URL,
+        // Preserve the server's actual accepted URL so a legacy-serving backend
+        // keeps working until it flips to the Hub path.
+        apiKeyUrl: apiKeyUrl,
         firstRegistrationCredits: value.first_registration,
         freeDailyCredits: value.free_daily,
     };

package/dist/remote-client.js

@@ -1,6 +1,7 @@
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";
 import { parseReaderCapabilities, selectUrlProfile, } from "./capabilities.js";
 import { BRIDGE_RELEASE_VERSION, REMOTE_CAPABILITIES_CUSTOM_FIELD, REMOTE_OMNI_MCP_URL, } from "./constants.js";
+import { API_KEY_URL } from "./onboarding-policy.js";
 import { OmniBridgeError } from "./errors.js";
 import { parseResultSchema } from "./result-contract.js";
 import { classifySource } from "./source.js";
@@ -206,7 +207,7 @@ export class HttpRemoteOmniClient {
                 code: "API_KEY_REQUIRED",
                 message: "A Cue API Key is required for Omni parsing.",
                 failureScope: "authentication",
-                userAction: "Create or configure an API Key at https://cuecue.cn/api-key without pasting it into chat.",
+                userAction: `Create or configure an API Key at ${API_KEY_URL} without pasting it into chat.`,
                 operationCreated: false,
                 retryable: false,
             });

package/package.json

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