@happyvertical/smrt-ingestion 0.57.20 → 0.57.22

package/dist/svelte/i18n.d.ts

@@ -24,6 +24,16 @@ export declare const M: {
     readonly 'ingestion.deferred': "ingestion.deferred";
     readonly 'ingestion.partially_completed': "ingestion.partially_completed";
     readonly 'ingestion.completed': "ingestion.completed";
+    readonly 'ingestion.resolved': "ingestion.resolved";
+    readonly 'ingestion.startAs': "ingestion.startAs";
+    readonly 'ingestion.startHandler': "ingestion.startHandler";
+    readonly 'ingestion.startArgs': "ingestion.startArgs";
+    readonly 'ingestion.start': "ingestion.start";
+    readonly 'ingestion.startHelp': "ingestion.startHelp";
+    readonly 'ingestion.resolveNoAction': "ingestion.resolveNoAction";
+    readonly 'ingestion.resolveReason': "ingestion.resolveReason";
+    readonly 'ingestion.resolvedBy': "ingestion.resolvedBy";
+    readonly 'ingestion.reviewerSelected': "ingestion.reviewerSelected";
     readonly 'ingestion.evidence': "ingestion.evidence";
     readonly 'ingestion.original': "ingestion.original";
     readonly 'ingestion.noOriginal': "ingestion.noOriginal";
@@ -33,6 +43,9 @@ export declare const M: {
     readonly 'ingestion.proposals': "ingestion.proposals";
     readonly 'ingestion.preview': "ingestion.preview";
     readonly 'ingestion.args': "ingestion.args";
+    readonly 'ingestion.suggestionArgs': "ingestion.suggestionArgs";
+    readonly 'ingestion.previewRejected': "ingestion.previewRejected";
+    readonly 'ingestion.completeSuggestion': "ingestion.completeSuggestion";
     readonly 'ingestion.effects': "ingestion.effects";
     readonly 'ingestion.approve': "ingestion.approve";
     readonly 'ingestion.reject': "ingestion.reject";
@@ -49,6 +62,20 @@ export declare const M: {
     readonly 'ingestion.choose': "ingestion.choose";
     readonly 'ingestion.split': "ingestion.split";
     readonly 'ingestion.saveSplit': "ingestion.saveSplit";
+    readonly 'ingestion.instructions': "ingestion.instructions";
+    readonly 'ingestion.reinterpret': "ingestion.reinterpret";
+    readonly 'ingestion.reinterpreting': "ingestion.reinterpreting";
+    readonly 'ingestion.appliedInstruction': "ingestion.appliedInstruction";
+    readonly 'ingestion.pendingInstruction': "ingestion.pendingInstruction";
+    readonly 'ingestion.refreshRetrying': "ingestion.refreshRetrying";
+    readonly 'ingestion.instructionNotRecorded': "ingestion.instructionNotRecorded";
+    readonly 'ingestion.instructionLength': "ingestion.instructionLength";
+    readonly 'ingestion.instructionInvalid': "ingestion.instructionInvalid";
+    readonly 'ingestion.droppedInstruction': "ingestion.droppedInstruction";
+    readonly 'ingestion.reinterpretNotStarted': "ingestion.reinterpretNotStarted";
+    readonly 'ingestion.instructionBusy': "ingestion.instructionBusy";
+    readonly 'ingestion.reinterpretFailed': "ingestion.reinterpretFailed";
+    readonly 'ingestion.instructionStale': "ingestion.instructionStale";
     readonly 'ingestion.result': "ingestion.result";
     readonly 'ingestion.stale': "ingestion.stale";
     readonly 'ingestion.revoked': "ingestion.revoked";
@@ -68,5 +95,34 @@ export declare const M: {
     readonly 'ingestion.state': "ingestion.state";
     readonly 'ingestion.reason': "ingestion.reason";
     readonly 'ingestion.feedbackSent': "ingestion.feedbackSent";
+    readonly 'ingestion.previousPage': "ingestion.previousPage";
+    readonly 'ingestion.nextPage': "ingestion.nextPage";
+    readonly 'ingestion.pageOf': "ingestion.pageOf";
+    readonly 'ingestion.previousOriginal': "ingestion.previousOriginal";
+    readonly 'ingestion.nextOriginal': "ingestion.nextOriginal";
+    readonly 'ingestion.originalOf': "ingestion.originalOf";
+    readonly 'ingestion.workspace': "ingestion.workspace";
+    readonly 'ingestion.selectedItem': "ingestion.selectedItem";
+    readonly 'ingestion.previousItem': "ingestion.previousItem";
+    readonly 'ingestion.nextItem': "ingestion.nextItem";
+    readonly 'ingestion.itemOf': "ingestion.itemOf";
+    readonly 'ingestion.selectItem': "ingestion.selectItem";
+    readonly 'ingestion.queueDone': "ingestion.queueDone";
+    readonly 'ingestion.unsavedLeave': "ingestion.unsavedLeave";
+    readonly 'ingestion.discardLeave': "ingestion.discardLeave";
+    readonly 'ingestion.stay': "ingestion.stay";
+    readonly 'ingestion.finishedUnsent': "ingestion.finishedUnsent";
+    readonly 'ingestion.advanceRetry': "ingestion.advanceRetry";
+    readonly 'ingestion.advanceFailed': "ingestion.advanceFailed";
+    readonly 'ingestion.keyboardHelp': "ingestion.keyboardHelp";
+    readonly 'ingestion.statusReason': "ingestion.statusReason";
+    readonly 'ingestion.backgroundUpdate': "ingestion.backgroundUpdate";
+    readonly 'ingestion.triage.pending': "ingestion.triage.pending";
+    readonly 'ingestion.triage.ready': "ingestion.triage.ready";
+    readonly 'ingestion.triage.needs_review': "ingestion.triage.needs_review";
+    readonly 'ingestion.triage.approval': "ingestion.triage.approval";
+    readonly 'ingestion.triage.apply': "ingestion.triage.apply";
+    readonly 'ingestion.triage.failed': "ingestion.triage.failed";
+    readonly 'ingestion.triage.missing': "ingestion.triage.missing";
 };
 //# sourceMappingURL=i18n.d.ts.map

package/dist/svelte/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/svelte/i18n.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEZ,CAAC"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/svelte/i18n.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+IZ,CAAC"}

package/dist/svelte/i18n.js

@@ -25,6 +25,16 @@ export const M = defineMessages({
     'ingestion.deferred': 'Deferred',
     'ingestion.partially_completed': 'Partially completed',
     'ingestion.completed': 'Completed',
+    'ingestion.resolved': 'Handled, no action',
+    'ingestion.startAs': 'Start action as…',
+    'ingestion.startHandler': 'Handler',
+    'ingestion.startArgs': 'Initial arguments (JSON)',
+    'ingestion.start': 'Start action',
+    'ingestion.startHelp': 'The handler previews these arguments; approval is a separate step.',
+    'ingestion.resolveNoAction': 'Handled, no action',
+    'ingestion.resolveReason': 'Reason for no action',
+    'ingestion.resolvedBy': 'Closed without action by {reviewer}',
+    'ingestion.reviewerSelected': 'Started by a reviewer',
     'ingestion.evidence': 'Original evidence',
     'ingestion.original': 'Open original',
     'ingestion.noOriginal': 'Original unavailable',
@@ -34,6 +44,9 @@ export const M = defineMessages({
     'ingestion.proposals': 'Proposed actions',
     'ingestion.preview': 'Prepare review',
     'ingestion.args': 'Exact arguments (JSON)',
+    'ingestion.suggestionArgs': 'Suggested arguments (JSON)',
+    'ingestion.previewRejected': 'These arguments did not pass the handler validation. Correct them and prepare review again.',
+    'ingestion.completeSuggestion': 'This suggestion needs review. Complete or confirm its arguments, then prepare review.',
     'ingestion.effects': 'Proposed effects',
     'ingestion.approve': 'Approve',
     'ingestion.reject': 'Reject',
@@ -50,6 +63,20 @@ export const M = defineMessages({
     'ingestion.choose': 'Choose destination',
     'ingestion.split': 'Logical page groups (JSON)',
     'ingestion.saveSplit': 'Save split and reprocess',
+    'ingestion.instructions': 'Instructions for the assistant',
+    'ingestion.reinterpret': 'Re-read with these instructions',
+    'ingestion.reinterpreting': 'Reinterpreting…',
+    'ingestion.appliedInstruction': 'Suggestions were produced under this instruction',
+    'ingestion.pendingInstruction': 'Latest instruction, not yet applied',
+    'ingestion.refreshRetrying': "Couldn't refresh; retrying.",
+    'ingestion.instructionNotRecorded': 'This item changed while you were writing; your instruction was not recorded.',
+    'ingestion.instructionLength': '{count} / {max} characters',
+    'ingestion.instructionInvalid': 'Enter an instruction of 1 to {max} characters. It was not recorded.',
+    'ingestion.droppedInstruction': "A reprocess replaced this item's extraction, so this instruction no longer applies. Re-record it to use it",
+    'ingestion.reinterpretNotStarted': 'The reinterpretation did not start. Re-read again to retry.',
+    'ingestion.instructionBusy': 'This item changed or is still being re-read. It has been refreshed; try again when it finishes.',
+    'ingestion.reinterpretFailed': 'The reinterpretation did not complete. Adjust the instruction or re-read again.',
+    'ingestion.instructionStale': 'Superseded: the current suggestions do not reflect the latest instruction.',
     'ingestion.result': 'Result',
     'ingestion.stale': 'Stale',
     'ingestion.revoked': 'Access revoked',
@@ -69,4 +96,33 @@ export const M = defineMessages({
     'ingestion.state': 'State',
     'ingestion.reason': 'Reason',
     'ingestion.feedbackSent': 'Feedback sent.',
+    'ingestion.previousPage': 'Previous page',
+    'ingestion.nextPage': 'Next page',
+    'ingestion.pageOf': 'Page {page} of {count}',
+    'ingestion.previousOriginal': 'Previous original',
+    'ingestion.nextOriginal': 'Next original',
+    'ingestion.originalOf': 'Original {index} of {count}',
+    'ingestion.workspace': 'Intake triage',
+    'ingestion.selectedItem': 'Selected item',
+    'ingestion.previousItem': 'Previous item',
+    'ingestion.nextItem': 'Next item',
+    'ingestion.itemOf': 'Item {index} of {count}',
+    'ingestion.selectItem': 'Choose an item from the list to review it here.',
+    'ingestion.queueDone': 'Nothing else in this list needs review.',
+    'ingestion.unsavedLeave': 'This item has input you have not sent. Leave it and discard that input?',
+    'ingestion.discardLeave': 'Discard and open the other item',
+    'ingestion.stay': 'Stay on this item',
+    'ingestion.finishedUnsent': 'Finished. You have unsent input on this item; move on with Next item when ready.',
+    'ingestion.advanceRetry': "Finished, but the next open item wasn't reached yet. Try Next item again.",
+    'ingestion.advanceFailed': "Finished, but the list couldn't load more items. Refresh the list to continue.",
+    'ingestion.keyboardHelp': 'Press J or K, or Alt+Down or Alt+Up, outside a text field to move between items.',
+    'ingestion.statusReason': '{status}: {reason}',
+    'ingestion.backgroundUpdate': '{label}: {status}',
+    'ingestion.triage.pending': 'Interpreting…',
+    'ingestion.triage.ready': 'Ready to review',
+    'ingestion.triage.needs_review': 'Needs review',
+    'ingestion.triage.approval': 'Awaiting approval',
+    'ingestion.triage.apply': 'Approved, not yet applied',
+    'ingestion.triage.failed': 'Failed',
+    'ingestion.triage.missing': 'missing {fields}',
 });

package/dist/svelte/index.d.ts

@@ -1,5 +1,6 @@
-export type { Assignment, EvidenceView, InboxEntry, InboxState, IntakeReviewHost, ItemReviewView, LogicalSplitInput, ReviewAction, ReviewPage, } from '../review-dto.js';
+export type { Assignment, EvidenceView, InboxEntry, InboxEvidence, InboxState, IntakeReviewHost, ItemReviewView, LogicalSplitInput, PreviewRejection, ReviewAction, ReviewerInstruction, ReviewerInstructionInput, ReviewerInstructionView, ReviewPage, } from '../review-dto.js';
 export { default as EvidenceViewer } from './components/EvidenceViewer.svelte';
 export { default as IntakeInbox } from './components/IntakeInbox.svelte';
 export { default as IntakeReview } from './components/IntakeReview.svelte';
+export { default as IntakeWorkspace } from './components/IntakeWorkspace.svelte';
 //# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/svelte/index.js

@@ -1,3 +1,4 @@
 export { default as EvidenceViewer } from './components/EvidenceViewer.svelte';
 export { default as IntakeInbox } from './components/IntakeInbox.svelte';
 export { default as IntakeReview } from './components/IntakeReview.svelte';
+export { default as IntakeWorkspace } from './components/IntakeWorkspace.svelte';

package/dist/svelte/view-utils.d.ts

@@ -1,7 +1,19 @@
 import type { EvidenceLocation } from '../extraction-types.js';
+import type { GeneratedSuggestion, ProposalCatalogEntry } from '../proposal-dto.js';
+import type { InboxEntry, InboxState, ItemReviewView } from '../review-dto.js';
+/**
+ * Initial arguments for a reviewer-chosen handler: a same-handler suggestion's
+ * arguments when one exists, otherwise evidence references for a single
+ * original. Nothing else is invented; the handler's preview validates them.
+ */
+export declare function draftArguments(entry: ProposalCatalogEntry, suggestions: readonly GeneratedSuggestion[], evidenceIds: readonly string[]): Record<string, unknown>;
+/** Required schema properties the draft does not supply yet. */
+export declare function missingArguments(entry: ProposalCatalogEntry, args: Record<string, unknown>): string[];
 /** Only host-authorized same-origin HTTP URLs may reach original media elements. */
 export declare function evidenceUrl(value?: string, origin?: string): string | undefined;
 export declare function argumentsObject(value: string): Record<string, unknown>;
+/** Required top-level handler arguments missing from a JSON draft; unparsable drafts report none. */
+export declare function missingRequired(schema: Record<string, unknown>, draft: string): string[];
 export declare function pageGroups(value: string): number[][];
 /** Project useful extraction content; never present internal configuration/provenance JSON. */
 export declare function extractedContent(output: Record<string, unknown>): Array<{
@@ -10,4 +22,59 @@ export declare function extractedContent(output: Record<string, unknown>): Array
     location?: EvidenceLocation;
     confidence?: number;
 }>;
+/**
+ * True while a background stage for the item is queued or running, including
+ * the server-reported gap between a completed extraction and its not yet
+ * appended interpretation. Presentation only: it drives polling, never access.
+ */
+export declare function reviewInFlight(view: ItemReviewView | undefined): boolean;
+/**
+ * A row's triage status. `state` falls back to the listed inbox state when
+ * nothing more specific is known (a row the reviewer has not opened).
+ */
+export type TriageStatus = {
+    kind: 'pending';
+} | {
+    kind: 'ready';
+} | {
+    kind: 'needs_review';
+    missing?: string[];
+    reason?: string;
+} | {
+    kind: 'approval';
+} | {
+    kind: 'apply';
+} | {
+    kind: 'failed';
+    reason?: string;
+} | {
+    kind: 'resolved';
+} | {
+    kind: 'state';
+    state: InboxState;
+};
+/** Status from a listed row alone: it carries no generation, so no reasons. */
+export declare function entryStatus(entry: InboxEntry): TriageStatus;
+/**
+ * Status from a loaded review view: what the reviewer would do next and, for
+ * a suggestion that needs review or a failed stage, a safe reason (missing
+ * argument names, a generation outcome or a failure category; never server
+ * exception text).
+ */
+export declare function viewStatus(view: ItemReviewView): TriageStatus;
+/** Rows the queue is finished with: closed without action or fully completed. */
+export declare function triageTerminal(status: TriageStatus): boolean;
+/**
+ * True when a reviewer operation left nothing for the reviewer on the item:
+ * it was closed without action, or at least one action succeeded and none is
+ * waiting for approval, waiting to be applied, executing, unknown or failed.
+ * Stale, rejected and deferred actions do not hold the item open.
+ */
+export declare function triageSettled(view: ItemReviewView): boolean;
+/**
+ * Highest observed page per evidence part, from extraction locations and
+ * proposed page groups. Only observed pages are navigable; a part without
+ * any is shown without page navigation.
+ */
+export declare function observedPages(view: ItemReviewView): Record<string, number>;
 //# sourceMappingURL=view-utils.d.ts.map

package/dist/svelte/view-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-utils.d.ts","sourceRoot":"","sources":["../../src/svelte/view-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,oFAAoF;AACpF,wBAAgB,WAAW,CACzB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAmBpB;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKtE;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAcpD;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAsED"}
+{"version":3,"file":"view-utils.d.ts","sourceRoot":"","sources":["../../src/svelte/view-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,oBAAoB,EAC3B,WAAW,EAAE,SAAS,mBAAmB,EAAE,EAC3C,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB;AACD,gEAAgE;AAChE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,EAAE,CAQV;AACD,oFAAoF;AACpF,wBAAgB,WAAW,CACzB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAmBpB;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKtE;AACD,qGAAqG;AACrG,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAWV;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAcpD;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAsED;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAQxE;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzC,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAU3D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAyC7D;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAkB3D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiB1E"}

package/dist/svelte/view-utils.js

@@ -1,3 +1,29 @@
+/**
+ * Initial arguments for a reviewer-chosen handler: a same-handler suggestion's
+ * arguments when one exists, otherwise evidence references for a single
+ * original. Nothing else is invented; the handler's preview validates them.
+ */
+export function draftArguments(entry, suggestions, evidenceIds) {
+    const suggestion = suggestions.find((candidate) => candidate.handlerId === entry.id &&
+        candidate.handlerVersion === entry.version);
+    // Plain JSON arguments; reactive state proxies cannot be structured-cloned.
+    const args = suggestion
+        ? JSON.parse(JSON.stringify(suggestion.args))
+        : {};
+    for (const [field, reference] of Object.entries(entry.references))
+        if (reference.kind === 'evidence' &&
+            !Object.hasOwn(args, field) &&
+            evidenceIds.length === 1)
+            args[field] = evidenceIds[0];
+    return args;
+}
+/** Required schema properties the draft does not supply yet. */
+export function missingArguments(entry, args) {
+    const required = entry.argsSchema.required;
+    return Array.isArray(required)
+        ? required.filter((field) => typeof field === 'string' && !Object.hasOwn(args, field))
+        : [];
+}
 /** Only host-authorized same-origin HTTP URLs may reach original media elements. */
 export function evidenceUrl(value, origin) {
     if (!value)
@@ -26,6 +52,18 @@ export function argumentsObject(value) {
         throw new Error('Invalid arguments');
     return result;
 }
+/** Required top-level handler arguments missing from a JSON draft; unparsable drafts report none. */
+export function missingRequired(schema, draft) {
+    if (!Array.isArray(schema.required))
+        return [];
+    try {
+        const values = argumentsObject(draft);
+        return schema.required.filter((name) => typeof name === 'string' && !Object.hasOwn(values, name));
+    }
+    catch {
+        return [];
+    }
+}
 export function pageGroups(value) {
     const result = JSON.parse(value);
     if (!Array.isArray(result) ||
@@ -94,3 +132,122 @@ export function extractedContent(output) {
     }
     return content;
 }
+/**
+ * True while a background stage for the item is queued or running, including
+ * the server-reported gap between a completed extraction and its not yet
+ * appended interpretation. Presentation only: it drives polling, never access.
+ */
+export function reviewInFlight(view) {
+    return (view?.availability === 'available' &&
+        !view.entry.item.disposition &&
+        (view.entry.state === 'processing' ||
+            ['queued', 'running'].includes(view.entry.item.processingState) ||
+            !!view.instruction?.reinterpreting));
+}
+/** Status from a listed row alone: it carries no generation, so no reasons. */
+export function entryStatus(entry) {
+    if (entry.item.disposition || entry.state === 'resolved')
+        return { kind: 'resolved' };
+    if (entry.state === 'processing' ||
+        ['queued', 'running'].includes(entry.item.processingState))
+        return { kind: 'pending' };
+    if (entry.state === 'failed')
+        return { kind: 'failed' };
+    return { kind: 'state', state: entry.state };
+}
+/**
+ * Status from a loaded review view: what the reviewer would do next and, for
+ * a suggestion that needs review or a failed stage, a safe reason (missing
+ * argument names, a generation outcome or a failure category; never server
+ * exception text).
+ */
+export function viewStatus(view) {
+    if (view.availability !== 'available')
+        return entryStatus(view.entry);
+    if (view.entry.item.disposition)
+        return { kind: 'resolved' };
+    if (reviewInFlight(view))
+        return { kind: 'pending' };
+    const failure = view.instruction?.failure;
+    if (failure)
+        return { kind: 'failed', reason: failure };
+    const states = view.reviews.actions.map((action) => action.review.state);
+    if (states.includes('waiting_review'))
+        return { kind: 'approval' };
+    if (states.includes('authorized'))
+        return { kind: 'apply' };
+    if (['completed', 'partially_completed', 'deferred', 'failed'].includes(view.entry.state) &&
+        states.length)
+        return entryStatus(view.entry);
+    const generation = view.generation;
+    if (generation?.outcome === 'provider_error')
+        return { kind: 'failed', reason: generation.outcome };
+    if (view.analysis?.result.error)
+        return { kind: 'failed', reason: view.analysis.result.error };
+    if (generation) {
+        if (generation.suggestions.some((suggestion) => suggestion.disposition === 'ready_for_review'))
+            return { kind: 'ready' };
+        const missing = [
+            ...new Set(generation.suggestions.flatMap((suggestion) => suggestion.missingFields)),
+        ];
+        if (missing.length)
+            return { kind: 'needs_review', missing };
+        return generation.suggestions.length
+            ? { kind: 'needs_review' }
+            : { kind: 'needs_review', reason: generation.outcome };
+    }
+    return entryStatus(view.entry);
+}
+/** Rows the queue is finished with: closed without action or fully completed. */
+export function triageTerminal(status) {
+    return (status.kind === 'resolved' ||
+        (status.kind === 'state' && status.state === 'completed'));
+}
+/**
+ * True when a reviewer operation left nothing for the reviewer on the item:
+ * it was closed without action, or at least one action succeeded and none is
+ * waiting for approval, waiting to be applied, executing, unknown or failed.
+ * Stale, rejected and deferred actions do not hold the item open.
+ */
+export function triageSettled(view) {
+    if (view.availability !== 'available')
+        return false;
+    if (view.entry.item.disposition)
+        return true;
+    // An unloaded saved-review page can still contain work for the reviewer.
+    if (view.reviews.nextCursor || reviewInFlight(view))
+        return false;
+    const states = view.reviews.actions.map((action) => action.review.state);
+    return (states.includes('succeeded') &&
+        !states.some((state) => [
+            'waiting_review',
+            'authorized',
+            'executing',
+            'outcome_unknown',
+            'failed',
+        ].includes(state)));
+}
+/**
+ * Highest observed page per evidence part, from extraction locations and
+ * proposed page groups. Only observed pages are navigable; a part without
+ * any is shown without page navigation.
+ */
+export function observedPages(view) {
+    const pages = {};
+    const note = (evidenceId, page) => {
+        if (Number.isSafeInteger(page) && page > 0)
+            pages[evidenceId] = Math.max(pages[evidenceId] ?? 0, page);
+    };
+    if (view.analysis)
+        for (const segment of extractedContent(view.analysis.result.output)) {
+            if (segment.location?.kind === 'page')
+                note(segment.evidenceId, segment.location.page);
+            if (segment.location?.kind === 'pages')
+                note(segment.evidenceId, segment.location.endPage);
+        }
+    for (const split of view.generation?.splits ?? [])
+        for (const group of split.groups)
+            for (const page of group)
+                note(split.evidenceId, page);
+    return pages;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-ingestion",
-  "version": "0.57.20",
+  "version": "0.57.22",
   "description": "Durable tenant-scoped intake and evidence foundations",
   "type": "module",
   "main": "./dist/index.js",
@@ -50,32 +50,32 @@
     }
   },
   "dependencies": {
-    "@happyvertical/smrt-core": "0.57.20",
-    "@happyvertical/smrt-types": "0.57.20",
-    "@happyvertical/smrt-tenancy": "0.57.20",
-    "@happyvertical/smrt-assets": "0.57.20",
-    "@happyvertical/smrt-jobs": "0.57.20",
+    "@happyvertical/smrt-core": "0.57.22",
+    "@happyvertical/smrt-types": "0.57.22",
+    "@happyvertical/smrt-tenancy": "0.57.22",
+    "@happyvertical/smrt-assets": "0.57.22",
+    "@happyvertical/smrt-jobs": "0.57.22",
     "@happyvertical/sql": "^0.106.0",
     "@happyvertical/pdf": "^0.65.9",
     "@happyvertical/ocr": "^0.62.1",
     "@happyvertical/speech": "^0.106.0",
     "@happyvertical/ai": "^0.106.0",
     "sharp": "^0.35.5",
-    "@happyvertical/smrt-agents": "0.57.20",
-    "@happyvertical/smrt-playbooks": "0.57.20",
+    "@happyvertical/smrt-agents": "0.57.22",
+    "@happyvertical/smrt-playbooks": "0.57.22",
     "ajv": "8.20.0",
-    "@happyvertical/smrt-ui": "0.57.20"
+    "@happyvertical/smrt-ui": "0.57.22"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.57.20",
+    "@happyvertical/smrt-vitest": "0.57.22",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.6",
     "vitest": "4.1.10",
-    "@happyvertical/smrt-content": "0.57.20",
-    "@happyvertical/smrt-messages": "0.57.20",
+    "@happyvertical/smrt-content": "0.57.22",
+    "@happyvertical/smrt-messages": "0.57.22",
     "@happyvertical/email": "^0.106.0",
-    "@happyvertical/smrt-users": "0.57.20",
+    "@happyvertical/smrt-users": "0.57.22",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "svelte": "^5.57.1",