@docmana/sdk 0.36.0-hitl.2 → 0.37.0

package/dist/reviews.d.ts

@@ -62,6 +62,18 @@ export interface ReviewItem {
     nodeName: string;
     field: string;
     value: unknown;
+    origin?: "proposed" | "confirmed" | "corrected";
+    originalValue?: unknown;
+}
+/** Captured node outputs. Downstream and dossier results are read-only. */
+export interface ReviewStep {
+    nodeId: string;
+    nodeName: string | null;
+    nodeType: string;
+    documentType?: string;
+    status: "provisional" | "failed" | "notExecuted";
+    score?: number;
+    items?: ReviewItem[];
 }
 export interface ReviewDocument {
     docKey: string;
@@ -78,7 +90,9 @@ export interface ReviewDocument {
     pagesComplete?: boolean;
     contentUrl?: string;
     items?: ReviewItem[];
+    /** Upstream fields/classifications may be corrected via continue; Core validates eligibility. */
     context?: ReviewItem[];
+    downstream?: ReviewStep[];
     /** Read-only evidence from the frozen pause; absent on older backends. */
     assessments?: ReviewAssessment[];
 }
@@ -107,10 +121,16 @@ export interface ReviewSummary {
         nodeType: string | null;
         instructions?: string;
     };
-    documents: ReviewDocument[];
+    /** The pending-list envelope omits document data. Read the selected task for it. */
+    documents?: ReviewDocument[];
     level?: "dossier";
+    priority?: "low" | "normal" | "high" | "urgent" | null;
+    waitingSince?: string | null;
 }
 export interface ReviewTask extends ReviewSummary {
+    documents: ReviewDocument[];
+    dossierContext?: Record<string, unknown>;
+    dossierResults?: ReviewStep[];
     /** Explicit frozen field signals. Missing/empty keeps legacy UI and global confirmation. */
     findings?: ReviewFinding[];
     /** Native lifecycle timestamps, absent on older backends; never inferred from callbacks. */
@@ -130,10 +150,15 @@ export interface ReviewDecision {
     decision: "continue" | "exclude" | "rerun" | "reject";
     reviewer: string;
     version: number;
+    /** Current items or upstream context fields/classifications, never downstream/status items. */
     corrections?: Array<{
         itemId: string;
         value: unknown;
+        reason?: string;
     }>;
+    /** Confirmations are limited to the current node's items. */
+    confirmations?: string[];
+    durationSeconds?: number;
     excludedDocuments?: string[];
     rerunDocuments?: string[];
     hint?: string;
@@ -160,6 +185,7 @@ export declare class Reviews {
     /** Published formula structure only. Compare its version with the review's flowVersion. */
     outline(flowId: string, options: ReviewReadOptions): Promise<ReviewFlowOutline>;
     list(options: ReviewReadOptions & {
+        /** The native API serves pending only. Other values are retained for older POC callers. */
         status?: "pending" | "submitted" | "resuming";
         cursor?: string;
         limit?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docmana/sdk",
-  "version": "0.36.0-hitl.2",
+  "version": "0.37.0",
   "description": "Official Docmana SDK — run document-analysis flows with a single call.",
   "license": "MIT",
   "type": "module",