@cueai/omni-reader-mcp 1.0.1 → 1.1.0

package/dist/onboarding-policy.d.ts

@@ -0,0 +1,10 @@
+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 interface OnboardingPolicy {
+    readonly apiKeyUrl: typeof API_KEY_URL;
+    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>;

package/dist/onboarding-policy.js

@@ -0,0 +1,58 @@
+export const ONBOARDING_POLICY_URL = "https://cuecue.cn/api/v1/billing/public/onboarding-policy";
+export const API_KEY_URL = "https://cuecue.cn/api-key";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function boundedCredits(value) {
+    return Number.isInteger(value) && Number(value) > 0 && Number(value) <= 1_000_000;
+}
+function normalizeOnboardingPolicy(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (value.api_key_url !== API_KEY_URL ||
+        !boundedCredits(value.first_registration) ||
+        !boundedCredits(value.free_daily))
+        return undefined;
+    return {
+        apiKeyUrl: API_KEY_URL,
+        firstRegistrationCredits: value.first_registration,
+        freeDailyCredits: value.free_daily,
+    };
+}
+export async function getOnboardingPolicy(fetchImpl, signal) {
+    try {
+        const response = await fetchImpl(ONBOARDING_POLICY_URL, {
+            method: "GET",
+            headers: { accept: "application/json" },
+            signal,
+        });
+        if (!response.ok)
+            return undefined;
+        return normalizeOnboardingPolicy(await response.json());
+    }
+    catch {
+        return undefined;
+    }
+}
+export function onboardingGuidance(policy) {
+    const creditLine = policy === undefined
+        ? `新账号有免费积分可体验，请前往 ${API_KEY_URL} 注册并创建 API Key。`
+        : `新账号首次注册赠送 ${policy.firstRegistrationCredits} 积分，免费账号每日有 ${policy.freeDailyCredits} 积分免费额度，可先体验 Omni，无需预先充值。`;
+    return [
+        "使用 Omni 需要配置 Cue API Key。",
+        `获取 API Key：${API_KEY_URL}`,
+        creditLine,
+        "创建后，请在 Agent 的安全密钥或环境设置中配置 CUE_API_KEY。请勿把 API Key 粘贴到对话中。",
+    ].join("\n");
+}
+export async function getOnboardingPolicyWithTimeout(fetchImpl, timeoutMs = 3_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    timer.unref?.();
+    try {
+        return await getOnboardingPolicy(fetchImpl, controller.signal);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/dist/operation-journal.d.ts

@@ -1,13 +1,55 @@
-export type JournalState = "GRANT_PENDING" | "GRANT_ISSUED";
+export type JournalState = "CREATED" | "GRANT_PENDING" | "GRANT_ISSUED" | "UPLOADING" | "PROCESSING" | "RESULT_READY" | "ACK_PENDING" | "CLEANUP_PENDING" | "COMPLETED" | "FAILED" | "CANCELED" | "EXPIRED";
+export type JournalProgressUnit = "page" | "sheet" | "slide" | "frame" | "segment";
+export type JournalCleanupState = "not_created" | "in_use" | "pending" | "deleted";
+export type JournalDeliveryState = "not_created" | "pending" | "deleted_after_ack";
+export interface JournalProgress {
+    readonly unit: JournalProgressUnit;
+    readonly completed: number;
+    readonly total: number;
+}
 export interface JournalRecord {
     readonly clientRequestId: string;
     readonly requestHash: string;
+    readonly sourceLocatorHash: string | null;
+    readonly sourceKind: "local" | "url";
     readonly operationId: string | null;
     readonly operationToken: string | null;
     readonly uploadUrl: string | null;
     readonly state: JournalState;
     readonly createdAt: string;
+    readonly updatedAt: string;
     readonly expiresAt: string | null;
+    readonly stage: string | null;
+    readonly progressPercent: number;
+    readonly progress: JournalProgress | null;
+    readonly fileUploaded: boolean;
+    readonly parserStarted: boolean;
+    readonly billed: boolean;
+    readonly contentReleased: boolean;
+    readonly processingCopy: JournalCleanupState;
+    readonly temporaryData: JournalCleanupState;
+    readonly deliveryResult: JournalDeliveryState;
+    readonly resultId: string | null;
+    readonly resultExpiresAt: string | null;
+    readonly errorCode: string | null;
+}
+export interface JournalPatch {
+    readonly operationId?: string | null;
+    readonly operationToken?: string | null;
+    readonly expiresAt?: string | null;
+    readonly stage?: string | null;
+    readonly progressPercent?: number;
+    readonly progress?: JournalProgress | null;
+    readonly fileUploaded?: boolean;
+    readonly parserStarted?: boolean;
+    readonly billed?: boolean;
+    readonly contentReleased?: boolean;
+    readonly processingCopy?: JournalCleanupState;
+    readonly temporaryData?: JournalCleanupState;
+    readonly deliveryResult?: JournalDeliveryState;
+    readonly resultId?: string | null;
+    readonly resultExpiresAt?: string | null;
+    readonly errorCode?: string | null;
 }
 export interface IssuedGrantJournalFields {
     readonly operationId: string;
@@ -22,6 +64,13 @@ export interface OperationJournalOptions {
 export declare class OperationJournal {
     #private;
     constructor(options?: OperationJournalOptions);
+    beginIntent(clientRequestId: string, requestHash: string, sourceKind?: "local" | "url", sourceLocatorHash?: string | null): Promise<JournalRecord>;
+    transition(clientRequestId: string, expectedState: JournalState, nextState: JournalState, patch: JournalPatch): Promise<JournalRecord>;
+    loadByRequestId(clientRequestId: string): Promise<JournalRecord | null>;
+    loadByOperationId(operationId: string): Promise<JournalRecord | null>;
+    loadLatestByRequestHash(requestHash: string): Promise<JournalRecord | null>;
+    loadLatestBySourceLocatorHash(sourceLocatorHash: string): Promise<JournalRecord | null>;
+    listRecoverable(): Promise<JournalRecord[]>;
     begin(clientRequestId: string, requestHash: string): Promise<JournalRecord>;
     markGrantIssued(clientRequestId: string, fields: IssuedGrantJournalFields): Promise<JournalRecord>;
     load(clientRequestId: string): Promise<JournalRecord | null>;