@cueai/omni-reader-mcp 1.1.3 → 1.2.0

package/dist/operation-journal.d.ts

@@ -1,3 +1,4 @@
+import { type RepresentationIntent } from "./protocol.js";
 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";
@@ -7,11 +8,20 @@ export interface JournalProgress {
     readonly completed: number;
     readonly total: number;
 }
+export type JournalSourceKind = "local" | "url";
+export type JournalDetail = "text" | "grounded" | "layout";
+export type JournalGroundingSchemaVersion = "none" | "omni.grounding.v1";
+export type JournalBundleProtocolVersion = "none" | "omni.result_bundle.v1";
 export interface JournalRecord {
     readonly clientRequestId: string;
-    readonly requestHash: string;
+    readonly requestIdentityHmac: string | null;
+    readonly sourceLocatorHmac: string | null;
+    readonly requestHash: string | null;
     readonly sourceLocatorHash: string | null;
-    readonly sourceKind: "local" | "url";
+    readonly sourceKind: JournalSourceKind;
+    readonly detail: JournalDetail;
+    readonly groundingSchemaVersion: JournalGroundingSchemaVersion;
+    readonly bundleProtocolVersion: JournalBundleProtocolVersion;
     readonly operationId: string | null;
     readonly operationToken: string | null;
     readonly uploadUrl: string | null;
@@ -61,6 +71,7 @@ export interface OperationJournalOptions {
     readonly rootDirectory?: string;
     readonly now?: () => Date;
 }
+export declare const LEGACY_RECOVERY_FAILURE_CODE = "SOURCE_FACTS_NOT_RECOVERABLE";
 /**
  * Rename with a Windows fallback. Node's rename() rejects replacing an
  * existing destination on Windows with EPERM instead of overwriting
@@ -72,12 +83,15 @@ export declare function renameWithFallback(sourcePath: string, destinationPath:
 export declare class OperationJournal {
     #private;
     constructor(options?: OperationJournalOptions);
-    beginIntent(clientRequestId: string, requestHash: string, sourceKind?: "local" | "url", sourceLocatorHash?: string | null): Promise<JournalRecord>;
+    requestIdentityHmac(canonicalIdentityJson: string): Promise<string>;
+    sourceLocatorHmac(sourceLocator: string): Promise<string>;
+    beginIntent(clientRequestId: string, canonicalIdentityJson: string, sourceKind?: JournalSourceKind, sourceLocator?: string | null, representation?: RepresentationIntent): Promise<JournalRecord>;
+    migrateLegacyRecord(clientRequestId: string, canonicalIdentityJson: string, sourceLocator?: string | null): Promise<JournalRecord | null>;
     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>;
+    loadLatestByRequestIdentityHmac(requestIdentityHmac: string): Promise<JournalRecord | null>;
+    loadLatestBySourceLocatorHmac(sourceLocatorHmac: string): Promise<JournalRecord | null>;
     listRecoverable(): Promise<JournalRecord[]>;
     begin(clientRequestId: string, requestHash: string): Promise<JournalRecord>;
     markGrantIssued(clientRequestId: string, fields: IssuedGrantJournalFields): Promise<JournalRecord>;