@happyvertical/smrt-ingestion 0.57.21 → 0.57.23

package/dist/svelte/components/ActionReview.svelte

@@ -1,3 +1,7 @@
+<script lang="ts" module>
+/** A reviewer operation whose result may finish the item for this reviewer. */
+export type ReviewOutcome = 'approve' | 'apply' | 'resolve';
+</script>
 <script lang="ts">
 import { Input, Textarea } from '@happyvertical/smrt-ui/forms';
 import { useI18n } from '@happyvertical/smrt-ui/i18n';
@@ -15,11 +19,28 @@ export interface Props {
   action: ReviewAction;
   catalog?: ProposalCatalogEntry;
   currentAttemptId?: string;
-  run: (operation: () => Promise<unknown>) => Promise<void>;
+  /** A resolved item is terminal: approve/correct/defer/apply and edits are hidden; only reject remains. */
+  resolved?: boolean;
+  /** `outcome` names an approve or apply so the parent can report it after its reload. */
+  run: (
+    operation: () => Promise<unknown>,
+    outcome?: ReviewOutcome,
+  ) => Promise<void>;
   deny: () => void;
+  /** Whether this editor holds unsent input (arguments, reason, comment). */
+  ondirty?: (dirty: boolean) => void;
 }
-let { host, itemId, action, catalog, currentAttemptId, run, deny }: Props =
-  $props();
+let {
+  host,
+  itemId,
+  action,
+  catalog,
+  currentAttemptId,
+  resolved = false,
+  run,
+  deny,
+  ondirty,
+}: Props = $props();
 const { t } = useI18n();
 // ReviewView keys this editor by action/revision/reviewVersion; edits are local to that binding.
 let args = $state(untrack(() => JSON.stringify(action.args, null, 2) ?? '')),
@@ -32,11 +53,18 @@ let args = $state(untrack(() => JSON.stringify(action.args, null, 2) ?? '')),
 let alive = true;
 onDestroy(() => {
   alive = false;
+  // The editor's local input goes with it.
+  ondirty?.(false);
 });
 const dirty = $derived(
   args !== (JSON.stringify(action.args, null, 2) ?? '') ||
     planArgs !== (JSON.stringify(action.plan?.args, null, 2) ?? ''),
 );
+const unsent = $derived(dirty || !!reason || !!comment);
+$effect(() => {
+  const edited = unsent;
+  untrack(() => ondirty?.(edited));
+});
 const waiting = $derived(
   action.args !== undefined && action.review.state === 'waiting_review',
 );
@@ -87,6 +115,7 @@ async function decide(decision: ReviewInput['decision']) {
       ...(reason ? { reason } : {}),
       ...(correctedArgs ? { correctedArgs } : {}),
     }),
+    decision === 'approve' ? 'approve' : undefined,
   );
 }
 async function saveEdits() {
@@ -161,6 +190,7 @@ function choose(field: string, id: string) {
 </script>
 <article data-testid={`action-${action.review.actionId}`}>
 <h3>{action.handlerId ?? action.review.actionId}</h3>
+{#if action.origin === 'reviewer-selected'}<p>{t(M['ingestion.reviewerSelected'])}</p>{/if}
 <p>{t(M['ingestion.state'])}: {action.review.state}</p>
 {#if action.args !== undefined}
 <h4>{t(M['ingestion.effects'])}</h4><pre>{JSON.stringify(action.review.display,null,2)}</pre>
@@ -171,30 +201,30 @@ function choose(field: string, id: string) {
 {#if !action.plan && catalog}<CandidatePicker {host} {itemId} {catalog} {deny} onchoose={choose} />{/if}
 {#if dirty}<p>{t(M['ingestion.reviewAgain'])}</p>{/if}
 {#if invalid}<p role="alert">{t(M['ingestion.invalid'])}</p>{/if}
-<div class="controls">{#if waiting}<Button disabled={dirty} onclick={() => decide('approve')}>{t(M['ingestion.approve'])}</Button>{/if}{#if !action.plan}<Button disabled={!dirty} onclick={saveEdits}>{t(M['ingestion.correct'])}</Button>{/if}{#if waiting}<Button onclick={() => decide('reject')}>{t(M['ingestion.reject'])}</Button><Button onclick={() => decide('defer')}>{t(M['ingestion.defer'])}</Button>{/if}</div>
+<div class="controls">{#if waiting && !resolved}<Button disabled={dirty} onclick={() => decide('approve')}>{t(M['ingestion.approve'])}</Button>{/if}{#if !action.plan && !resolved}<Button disabled={!dirty} onclick={saveEdits}>{t(M['ingestion.correct'])}</Button>{/if}{#if waiting}<Button onclick={() => decide('reject')}>{t(M['ingestion.reject'])}</Button>{#if !resolved}<Button onclick={() => decide('defer')}>{t(M['ingestion.defer'])}</Button>{/if}{/if}</div>
 {/if}
-{#if action.plan?.stepIndex === 0 && action.plan.args && host.editPlan && planEditable}
+{#if action.plan?.stepIndex === 0 && action.plan.args && host.editPlan && planEditable && !resolved}
 <Textarea aria-label={t(M['ingestion.planArgs'])} bind:value={planArgs} rows={8} />
 {#if !editable && dirty}<p>{t(M['ingestion.reviewAgain'])}</p>{/if}
 {#if !editable && invalid}<p role="alert">{t(M['ingestion.invalid'])}</p>{/if}
 <Button onclick={editPlan}>{t(M['ingestion.editPlan'])}</Button>
 {/if}
-{#if action.review.state === 'authorized'}<Button disabled={dirty} onclick={() => { if (!dirty) void run(() => host.apply(action.review.actionId)); }}>{t(M['ingestion.apply'])}</Button>{/if}
+{#if action.review.state === 'authorized' && !resolved}<Button disabled={unsent} onclick={() => { if (!unsent) void run(() => host.apply(action.review.actionId), 'apply'); }}>{t(M['ingestion.apply'])}</Button>{/if}
 {/if}
-{#if action.review.state === 'stale' && !action.stalePlan && action.attemptId && host.editAction}
+{#if action.review.state === 'stale' && !action.stalePlan && action.attemptId && host.editAction && !resolved}
 <p>{t(M['ingestion.reviewAgain'])}</p>
 <Textarea aria-label={t(M['ingestion.args'])} bind:value={args} rows={8} />
 {#if invalid}<p role="alert">{t(M['ingestion.invalid'])}</p>{/if}
 <Button onclick={saveEdits}>{t(M['ingestion.correct'])}</Button>
 {/if}
-{#if action.review.state === 'stale' && action.stalePlan && currentAttemptId && host.editPlan}
+{#if action.review.state === 'stale' && action.stalePlan && currentAttemptId && host.editPlan && !resolved}
 <p>{t(M['ingestion.reviewAgain'])}</p>
 <Textarea aria-label={t(M['ingestion.planArgs'])} bind:value={planArgs} rows={8} />
 {#if invalid}<p role="alert">{t(M['ingestion.invalid'])}</p>{/if}
 <Button onclick={editPlan}>{t(M['ingestion.editPlan'])}</Button>
 {/if}
 {#if action.result}<h4>{t(M['ingestion.result'])}</h4><pre>{JSON.stringify(action.result,null,2)}</pre>{/if}
-{#if host.feedback && action.args !== undefined}<fieldset><legend>{t(M['ingestion.feedback'])}</legend><Textarea aria-label={t(M['ingestion.comment'])} bind:value={comment} /><Button disabled={dirty} onclick={() => run(() => host.feedback?.({itemId,actionId:action.review.actionId,expectedRevision:action.review.revision,expectedReviewVersion:action.review.reviewVersion,bindingHash:action.review.bindingHash,judgment:'correct',comment,requestId:crypto.randomUUID()}) ?? Promise.resolve())}>{t(M['ingestion.correctJudgment'])}</Button><Button disabled={dirty} onclick={() => run(() => host.feedback?.({itemId,actionId:action.review.actionId,expectedRevision:action.review.revision,expectedReviewVersion:action.review.reviewVersion,bindingHash:action.review.bindingHash,judgment:'incorrect',comment,requestId:crypto.randomUUID()}) ?? Promise.resolve())}>{t(M['ingestion.incorrectJudgment'])}</Button></fieldset>{/if}
+{#if host.feedback && action.args !== undefined && action.origin !== 'reviewer-selected'}<fieldset><legend>{t(M['ingestion.feedback'])}</legend><Textarea aria-label={t(M['ingestion.comment'])} bind:value={comment} /><Button disabled={dirty} onclick={() => run(() => host.feedback?.({itemId,actionId:action.review.actionId,expectedRevision:action.review.revision,expectedReviewVersion:action.review.reviewVersion,bindingHash:action.review.bindingHash,judgment:'correct',comment,requestId:crypto.randomUUID()}) ?? Promise.resolve())}>{t(M['ingestion.correctJudgment'])}</Button><Button disabled={dirty} onclick={() => run(() => host.feedback?.({itemId,actionId:action.review.actionId,expectedRevision:action.review.revision,expectedReviewVersion:action.review.reviewVersion,bindingHash:action.review.bindingHash,judgment:'incorrect',comment,requestId:crypto.randomUUID()}) ?? Promise.resolve())}>{t(M['ingestion.incorrectJudgment'])}</Button></fieldset>{/if}
 </article>
 <style>
 @layer smrt.reset, smrt.structure, smrt.theme;

package/dist/svelte/components/ActionReview.svelte.d.ts

@@ -1,3 +1,5 @@
+/** A reviewer operation whose result may finish the item for this reviewer. */
+export type ReviewOutcome = 'approve' | 'apply' | 'resolve';
 import type { ProposalCatalogEntry } from '../../proposal-dto.js';
 import type { IntakeReviewHost, ReviewAction } from '../../review-dto.js';
 export interface Props {
@@ -6,8 +8,13 @@ export interface Props {
     action: ReviewAction;
     catalog?: ProposalCatalogEntry;
     currentAttemptId?: string;
-    run: (operation: () => Promise<unknown>) => Promise<void>;
+    /** A resolved item is terminal: approve/correct/defer/apply and edits are hidden; only reject remains. */
+    resolved?: boolean;
+    /** `outcome` names an approve or apply so the parent can report it after its reload. */
+    run: (operation: () => Promise<unknown>, outcome?: ReviewOutcome) => Promise<void>;
     deny: () => void;
+    /** Whether this editor holds unsent input (arguments, reason, comment). */
+    ondirty?: (dirty: boolean) => void;
 }
 declare const ActionReview: import("svelte").Component<Props, {}, "">;
 type ActionReview = ReturnType<typeof ActionReview>;

package/dist/svelte/components/ActionReview.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionReview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ActionReview.svelte.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAK1E,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAmMD,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ActionReview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ActionReview.svelte.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAQ5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAK1E,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,GAAG,EAAE,CACH,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAsND,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/svelte/components/EvidenceViewer.svelte

@@ -6,19 +6,75 @@ import { M } from '../i18n.js';
 import { evidenceUrl } from '../view-utils.js';
 export interface Props {
   evidence: EvidenceView[];
+  /**
+   * Highest observed page per evidence id. A PDF with more than one observed
+   * page gets inline page navigation (the same-origin URL plus `#page=n`).
+   */
+  pages?: Record<string, number>;
+  /** `stack` lists every part; `pager` shows one part at a time with navigation. */
+  layout?: 'stack' | 'pager';
+  /** Bindable: the part the pager shows, by evidence id. */
+  chosen?: string;
+  /** Bindable: page per evidence id; absent until the reviewer navigates. */
+  page?: Record<string, number>;
 }
-let { evidence }: Props = $props();
+let {
+  evidence,
+  pages = {},
+  layout = 'stack',
+  // Bindable so a parent can keep them while this viewer remounts on reload.
+  chosen = $bindable(),
+  page = $bindable({}),
+}: Props = $props();
 const { t } = useI18n();
+const inline = (view: EvidenceView) =>
+  view.evidence.mediaType.startsWith('image/') ||
+  view.evidence.mediaType === 'application/pdf' ||
+  view.evidence.mediaType.startsWith('audio/');
+// The pager opens on the first part that renders inline (the uploaded file,
+// not its capture record); the reviewer can step to every other part.
+const shown = $derived.by(() => {
+  if (layout !== 'pager') return evidence;
+  const current =
+    evidence.find((view) => view.evidence.id === chosen) ??
+    evidence.find((view) => inline(view) && evidenceUrl(view.viewUrl)) ??
+    evidence[0];
+  return current ? [current] : [];
+});
+const position = $derived(shown.length === 1 ? evidence.indexOf(shown[0]) : -1);
+function step(offset: number) {
+  const next = evidence[position + offset];
+  if (next) chosen = next.evidence.id;
+}
+function pageUrl(url: string, id: string) {
+  const current = page[id];
+  return current === undefined ? url : `${url.split('#')[0]}#page=${current}`;
+}
+function turn(id: string, offset: number) {
+  const count = pages[id] ?? 1;
+  page = {
+    ...page,
+    [id]: Math.min(count, Math.max(1, (page[id] ?? 1) + offset)),
+  };
+}
 </script>
 <section data-testid="evidence-viewer" aria-label={t(M['ingestion.evidence'])} data-smrt-component="EvidenceViewer">
 <h2>{t(M['ingestion.evidence'])}</h2>
-{#each evidence as view (view.evidence.id)}
+{#if layout === 'pager' && evidence.length > 1 && position >= 0}
+<div class="pager" data-testid="evidence-pager"><Button disabled={position <= 0} onclick={() => step(-1)}>{t(M['ingestion.previousOriginal'])}</Button><p role="status">{t(M['ingestion.originalOf'], { index: position + 1, count: evidence.length })}</p><Button disabled={position >= evidence.length - 1} onclick={() => step(1)}>{t(M['ingestion.nextOriginal'])}</Button></div>
+{/if}
+{#each shown as view (view.evidence.id)}
 {@const url = evidenceUrl(view.viewUrl)}
+{@const count = pages[view.evidence.id] ?? 0}
 <article id={`evidence-${view.evidence.id}`}>
 <h3>{view.label}</h3>
 {#if url}
 {#if view.evidence.mediaType.startsWith('image/')}<img src={url} alt={view.label} />
-{:else if view.evidence.mediaType === 'application/pdf'}<iframe src={url} title={view.label}></iframe>
+{:else if view.evidence.mediaType === 'application/pdf'}
+{@const src = pageUrl(url, view.evidence.id)}
+{#if count > 1}{@const current = page[view.evidence.id] ?? 1}<div class="pager" data-testid="page-pager"><Button disabled={current <= 1} onclick={() => turn(view.evidence.id, -1)}>{t(M['ingestion.previousPage'])}</Button><p role="status">{t(M['ingestion.pageOf'], { page: current, count })}</p><Button disabled={current >= count} onclick={() => turn(view.evidence.id, 1)}>{t(M['ingestion.nextPage'])}</Button></div>{/if}
+<!-- A fragment-only change does not reliably move an embedded PDF viewer; a new frame does. -->
+{#key src}<iframe {src} title={view.label}></iframe>{/key}
 {:else if view.evidence.mediaType.startsWith('audio/')}<audio controls src={url} aria-label={view.label}></audio>{/if}
 <Button href={url} target="_blank" rel="noopener noreferrer">{t(M['ingestion.original'])}</Button>
 {:else}<p>{t(M['ingestion.noOriginal'])}</p>{/if}
@@ -29,6 +85,6 @@ const { t } = useI18n();
 <style>
 @layer smrt.reset, smrt.structure, smrt.theme;
 @layer smrt.theme {
-section,article{min-width:0}article{margin-block:1rem}img,iframe,audio{display:block;max-width:100%;width:100%;margin-block:.5rem}img{object-fit:contain;max-height:32rem}iframe{height:32rem;border:var(--smrt-hairline)}pre{white-space:pre-wrap;overflow-wrap:anywhere}
+section,article{min-width:0}article{margin-block:1rem}img,iframe,audio{display:block;max-width:100%;width:100%;margin-block:.5rem}img{object-fit:contain;max-height:32rem}iframe{height:32rem;border:var(--smrt-hairline)}pre{white-space:pre-wrap;overflow-wrap:anywhere}.pager{display:flex;flex-wrap:wrap;align-items:center;gap:.5rem}.pager p{margin:0}
 }
 </style>

package/dist/svelte/components/EvidenceViewer.svelte.d.ts

@@ -1,8 +1,19 @@
 import type { EvidenceView } from '../../review-dto.js';
 export interface Props {
     evidence: EvidenceView[];
+    /**
+     * Highest observed page per evidence id. A PDF with more than one observed
+     * page gets inline page navigation (the same-origin URL plus `#page=n`).
+     */
+    pages?: Record<string, number>;
+    /** `stack` lists every part; `pager` shows one part at a time with navigation. */
+    layout?: 'stack' | 'pager';
+    /** Bindable: the part the pager shows, by evidence id. */
+    chosen?: string;
+    /** Bindable: page per evidence id; absent until the reviewer navigates. */
+    page?: Record<string, number>;
 }
-declare const EvidenceViewer: import("svelte").Component<Props, {}, "">;
+declare const EvidenceViewer: import("svelte").Component<Props, {}, "page" | "chosen">;
 type EvidenceViewer = ReturnType<typeof EvidenceViewer>;
 export default EvidenceViewer;
 //# sourceMappingURL=EvidenceViewer.svelte.d.ts.map

package/dist/svelte/components/EvidenceViewer.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EvidenceViewer.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/EvidenceViewer.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AA+BD,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"EvidenceViewer.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/EvidenceViewer.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AA4ED,QAAA,MAAM,cAAc,0DAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/svelte/components/InboxView.svelte

@@ -19,8 +19,39 @@ export interface Props {
    * page of rows does not add one complementary landmark per row.
    */
   rowAside?: Snippet<[InboxEntry]>;
+  /** The row a workspace has open; marked `aria-current`. */
+  selectedId?: string;
+  /**
+   * The displayed rows after every settled load or page append (not after
+   * `patch`, which returns them), whether more pages exist, and the entries
+   * exactly as the page read returned them (`appended` for Load more), absent
+   * when the read failed.
+   */
+  onitems?: (
+    items: InboxEntry[],
+    more: boolean,
+    page?: { entries: InboxEntry[]; appended: boolean; issued?: number },
+  ) => void;
+  /** Called before a page request so a workspace can order concurrent follow reads. */
+  onreadstart?: () => void;
+  /** A row's status text; the listed inbox state is shown when omitted or undefined. */
+  status?: (entry: InboxEntry) => string | undefined;
+  /** Show the per-row "Handled, no action" control (a workspace resolves in its item pane). */
+  resolveInRow?: boolean;
+  /** Numbers each page read when its request starts (`issued` on the page). */
+  stamp?: () => number;
 }
-let { host, onselect, rowAside }: Props = $props();
+let {
+  host,
+  onselect,
+  rowAside,
+  selectedId,
+  onitems,
+  onreadstart,
+  status,
+  resolveInRow = true,
+  stamp,
+}: Props = $props();
 const { t } = useI18n();
 const states: InboxState[] = [
   'processing',
@@ -30,11 +61,13 @@ const states: InboxState[] = [
   'deferred',
   'partially_completed',
   'completed',
+  'resolved',
 ];
 let items = $state<InboxEntry[]>([]),
   selectedState = $state(''),
   assignee = $state(''),
   assignments = $state<Record<string, string>>({}),
+  reasons = $state<Record<string, string>>({}),
   files = $state<File[]>([]),
   cursor = $state<string>(),
   pending = $state(false),
@@ -42,41 +75,145 @@ let items = $state<InboxEntry[]>([]),
 let alive = true,
   epoch = 0;
 let uploadRequestId: string | undefined;
+// The filter the displayed rows were listed under (the inputs may have been
+// edited since); `patch` keeps a row only while it still matches it.
+let listed: { state?: InboxState; assigneeId?: string } = {};
+function publish(page?: {
+  entries: InboxEntry[];
+  appended: boolean;
+  issued?: number;
+}) {
+  onitems?.($state.snapshot(items) as InboxEntry[], !!cursor, page);
+}
+/**
+ * Replace one displayed row with a fresher entry for the same item (item and
+ * state; the assignment only when its version is newer), keeping its listed
+ * label and preview: `load` entries
+ * carry no preview and a host may label them differently. Unless `keep` is
+ * set, a row that no longer matches the listed filter leaves the list. Rows
+ * that are not displayed are never added. Returns the displayed rows.
+ */
+export function patch(entry: InboxEntry, keep = false): InboxEntry[] {
+  const index = items.findIndex((row) => row.item.id === entry.item.id);
+  if (index < 0) return $state.snapshot(items) as InboxEntry[];
+  const previous = items[index];
+  // Assignment is versioned (the host's compare-and-set): an entry carrying
+  // an older or equal version never replaces the row's, so a view loaded
+  // before an assignment cannot roll the row (and the next expected version)
+  // back.
+  const newer = entry.assignment.version > previous.assignment.version;
+  const assignment = newer ? entry.assignment : previous.assignment;
+  const matches =
+    (!listed.state || entry.state === listed.state) &&
+    (!listed.assigneeId || assignment.assigneeId === listed.assigneeId);
+  if (keep || matches) {
+    const evidence = previous.evidence;
+    items[index] = {
+      item: entry.item,
+      label: previous.label,
+      state: entry.state,
+      assignment: $state.snapshot(assignment),
+      ...(evidence ? { evidence } : {}),
+    };
+    // An unsaved assignee the reviewer typed survives unless the durable
+    // assignment itself changed.
+    if (newer) assignments[entry.item.id] = assignment.assigneeId ?? '';
+  } else items = items.filter((row) => row.item.id !== entry.item.id);
+  return $state.snapshot(items) as InboxEntry[];
+}
+/**
+ * Append the next page, if any. Resolves with the displayed rows and what
+ * happened: `appended` (or `none` when there is no further page), `pending`
+ * when another read was in flight or superseded this one (nothing was
+ * appended), or `failed` when the page read failed (the list failed closed
+ * and its rows were cleared).
+ */
+export async function more(): Promise<{
+  items: InboxEntry[];
+  result: 'appended' | 'none' | 'pending' | 'failed';
+}> {
+  let result: 'appended' | 'none' | 'pending' | 'failed';
+  if (pending) result = 'pending';
+  else if (!cursor) result = 'none';
+  else {
+    const read = await load(true);
+    result =
+      read === 'shown' ? 'appended' : read === 'failed' ? 'failed' : 'pending';
+  }
+  return { items: $state.snapshot(items) as InboxEntry[], result };
+}
 onDestroy(() => {
   alive = false;
   epoch++;
   files = [];
   uploadRequestId = undefined;
 });
-async function load(more = false) {
+/**
+ * Resolves `shown` when this read's page was displayed, `failed` when it
+ * failed (the rows were cleared), `superseded` when a newer read or the
+ * component's end fenced it.
+ */
+async function load(more = false): Promise<'shown' | 'failed' | 'superseded'> {
   const ticket = ++epoch;
+  onreadstart?.();
   pending = true;
   error = false;
-  const prior = more ? items : [];
+  let page:
+    | { entries: InboxEntry[]; appended: boolean; issued?: number }
+    | undefined;
   const next = more ? cursor : undefined;
-  items = [];
-  assignments = {};
+  // The displayed rows stay (controls disabled while pending) until the new
+  // page arrives, so a workspace can keep patching and navigating them; a
+  // failed read still clears them.
+  const filter = more
+    ? listed
+    : {
+        state: selectedState ? (selectedState as InboxState) : undefined,
+        assigneeId: assignee || undefined,
+      };
   try {
-    const page = await host.list({
-      state: selectedState ? (selectedState as InboxState) : undefined,
-      assigneeId: assignee || undefined,
-      cursor: next,
-    });
-    if (!alive || ticket !== epoch) return;
-    items = [...prior, ...page.items];
-    cursor = page.nextCursor;
+    const issued = stamp?.();
+    const read = await host.list({ ...filter, cursor: next });
+    if (!alive || ticket !== epoch) return 'superseded';
+    listed = filter;
+    // An appended page builds on the rows as displayed now (patches made
+    // while it loaded included); a row already shown is not repeated.
+    const shown = new Set(more ? items.map((entry) => entry.item.id) : []);
+    const added = read.items.filter((entry) => !shown.has(entry.item.id));
+    page = {
+      entries: $state.snapshot(more ? added : read.items) as InboxEntry[],
+      appended: more,
+      ...(issued !== undefined ? { issued } : {}),
+    };
+    const kept = more ? { assignments, reasons } : undefined;
+    items = more ? [...items, ...added] : read.items;
+    cursor = read.nextCursor;
     assignments = Object.fromEntries(
-      items.map((entry) => [entry.item.id, entry.assignment.assigneeId ?? '']),
+      items.map((entry) => [
+        entry.item.id,
+        kept?.assignments[entry.item.id] ?? entry.assignment.assigneeId ?? '',
+      ]),
+    );
+    reasons = Object.fromEntries(
+      items.map((entry) => [entry.item.id, kept?.reasons[entry.item.id] ?? '']),
     );
   } catch {
+    // Any failed read, Load more included, fails closed: the host cannot say
+    // whether it was transient or a revoked grant.
     if (alive && ticket === epoch) {
       items = [];
+      assignments = {};
+      reasons = {};
       cursor = undefined;
       error = true;
     }
   } finally {
-    if (alive && ticket === epoch) pending = false;
+    if (alive && ticket === epoch) {
+      pending = false;
+      publish(page);
+    }
   }
+  return page ? 'shown' : alive && ticket === epoch ? 'failed' : 'superseded';
 }
 async function mutate(operation: () => Promise<unknown>, selected = false) {
   if (pending) return;
@@ -99,6 +236,7 @@ async function mutate(operation: () => Promise<unknown>, selected = false) {
       assignments = {};
       error = true;
       pending = false;
+      publish();
     }
   }
 }
@@ -126,8 +264,8 @@ onMount(() => {
 {#if error}<p role="alert">{t(M['ingestion.error'])}</p>{/if}
 {#if pending}<p role="status">{t(M['ingestion.loading'])}</p>{/if}
 {#if !pending && !error && !items.length}<p>{t(M['ingestion.empty'])}</p>{/if}
-<ul>{#each items as entry (entry.item.id)}<li>
-<h2>{entry.label}</h2><p>{t(M[`ingestion.${entry.state}`])}</p>
+<ul>{#each items as entry (entry.item.id)}<li data-item-id={entry.item.id} aria-current={entry.item.id === selectedId ? 'true' : undefined} class:selected={entry.item.id === selectedId}>
+<h2>{entry.label}</h2><p data-testid="row-status">{status?.(entry) ?? t(M[`ingestion.${entry.state}`])}</p>
 {#if rowAside}<div class="row-aside">{@render rowAside(entry)}</div>{:else if entry.evidence}{@const original = evidenceUrl(entry.evidence.viewUrl)}{@const thumbnail = evidenceUrl(entry.evidence.thumbnailUrl)}{#if thumbnail || original}<div class="row-aside">
 {#if thumbnail}<img src={thumbnail} alt={entry.evidence.label} loading="lazy" />{/if}
 {#if original}<a href={original} target="_blank" rel="noopener noreferrer" aria-label={`${t(M['ingestion.original'])}: ${entry.label}`}>{t(M['ingestion.original'])}</a>{/if}
@@ -135,12 +273,16 @@ onMount(() => {
 <Button onclick={() => onselect?.(entry.item.id)} disabled={pending}>{t(M['ingestion.open'])}</Button>
 <Input aria-label={`${t(M['ingestion.assignee'])}: ${entry.label}`} bind:value={assignments[entry.item.id]} disabled={pending} />
 <Button disabled={pending} onclick={() => mutate(() => host.assign({itemId:entry.item.id,expectedVersion:entry.assignment.version,assigneeId:assignments[entry.item.id] || null,requestId:crypto.randomUUID()}))}>{t(M['ingestion.assign'])}</Button>
+{#if resolveInRow && host.resolve && !entry.item.disposition}
+<Input aria-label={`${t(M['ingestion.resolveReason'])}: ${entry.label}`} bind:value={reasons[entry.item.id]} disabled={pending} />
+<Button disabled={pending} onclick={() => { const close = host.resolve; const reason = reasons[entry.item.id]; if (close) void mutate(() => close({itemId:entry.item.id,disposition:'resolve_no_action',requestId:crypto.randomUUID(),...(reason ? { reason } : {})})); }}>{t(M['ingestion.resolveNoAction'])}</Button>
+{/if}
 </li>{/each}</ul>
 {#if cursor}<Button disabled={pending} onclick={() => load(true)}>{t(M['ingestion.more'])}</Button>{/if}
 </section>
 <style>
 @layer smrt.reset, smrt.structure, smrt.theme;
 @layer smrt.theme {
-section{max-width:72rem;margin-inline:auto;padding:1rem;color:var(--smrt-color-on-surface)}.toolbar{display:flex;flex-wrap:wrap;gap:.75rem;margin-block:1rem}ul{list-style:none;padding:0}li{padding:1rem;border-block-end:var(--smrt-hairline);display:grid;gap:.75rem}h2{font-size:1.1rem}.row-aside{display:flex;flex-wrap:wrap;align-items:center;gap:.75rem}.row-aside img{max-block-size:6rem;max-inline-size:100%;object-fit:contain}
+section{max-width:72rem;margin-inline:auto;padding:1rem;color:var(--smrt-color-on-surface)}.toolbar{display:flex;flex-wrap:wrap;gap:.75rem;margin-block:1rem}ul{list-style:none;padding:0}li{padding:1rem;border-block-end:var(--smrt-hairline);display:grid;gap:.75rem}li.selected{border-inline-start:.25rem solid var(--smrt-color-primary)}h2{font-size:1.1rem}.row-aside{display:flex;flex-wrap:wrap;align-items:center;gap:.75rem}.row-aside img{max-block-size:6rem;max-inline-size:100%;object-fit:contain}
 }
 </style>

package/dist/svelte/components/InboxView.svelte.d.ts

@@ -9,8 +9,35 @@ export interface Props {
      * page of rows does not add one complementary landmark per row.
      */
     rowAside?: Snippet<[InboxEntry]>;
+    /** The row a workspace has open; marked `aria-current`. */
+    selectedId?: string;
+    /**
+     * The displayed rows after every settled load or page append (not after
+     * `patch`, which returns them), whether more pages exist, and the entries
+     * exactly as the page read returned them (`appended` for Load more), absent
+     * when the read failed.
+     */
+    onitems?: (items: InboxEntry[], more: boolean, page?: {
+        entries: InboxEntry[];
+        appended: boolean;
+        issued?: number;
+    }) => void;
+    /** Called before a page request so a workspace can order concurrent follow reads. */
+    onreadstart?: () => void;
+    /** A row's status text; the listed inbox state is shown when omitted or undefined. */
+    status?: (entry: InboxEntry) => string | undefined;
+    /** Show the per-row "Handled, no action" control (a workspace resolves in its item pane). */
+    resolveInRow?: boolean;
+    /** Numbers each page read when its request starts (`issued` on the page). */
+    stamp?: () => number;
 }
-declare const InboxView: import("svelte").Component<Props, {}, "">;
+declare const InboxView: import("svelte").Component<Props, {
+    patch: (entry: InboxEntry, keep?: boolean) => InboxEntry[];
+    more: () => Promise<{
+        items: InboxEntry[];
+        result: "appended" | "none" | "pending" | "failed";
+    }>;
+}, "">;
 type InboxView = ReturnType<typeof InboxView>;
 export default InboxView;
 //# sourceMappingURL=InboxView.svelte.d.ts.map

package/dist/svelte/components/InboxView.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InboxView.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/InboxView.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EACV,UAAU,EAEV,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CAClC;AAoID,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"InboxView.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/InboxView.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EACV,UAAU,EAEV,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACjC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KACjE,IAAI,CAAC;IACV,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,sFAAsF;IACtF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,GAAG,SAAS,CAAC;IACnD,6FAA6F;IAC7F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AA6PD,QAAA,MAAM,SAAS;mBA/LQ,UAAU,qBAAiB,UAAU,EAAE;gBAmCtC,OAAO,CAAC;QAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;QACpB,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;KACpD,CAAC;MAyJqD,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/svelte/components/IntakeWorkspace.svelte

@@ -0,0 +1,27 @@
+<script lang="ts">
+import type { Snippet } from 'svelte';
+import type { InboxEntry, IntakeReviewHost } from '../../review-dto.js';
+import TriageView from './TriageView.svelte';
+export interface Props {
+  host: IntakeReviewHost;
+  /** Replace whenever the authenticated tenant/session context changes. */
+  contextKey?: string;
+  /** Item to open first; afterwards the workspace owns the selection. */
+  itemId?: string;
+  /** Reload interval while an item's background stage is in flight. */
+  pollMs?: number;
+  /** Told about every selection change (e.g. to keep a URL in step); never navigates. */
+  onselect?: (itemId: string | undefined) => void;
+  /** Optional per-row aside (preview, original link); receives the page entry. */
+  rowAside?: Snippet<[InboxEntry]>;
+}
+let {
+  host,
+  contextKey = '',
+  itemId,
+  pollMs = 2000,
+  onselect,
+  rowAside,
+}: Props = $props();
+</script>
+{#key host}{#key contextKey}<TriageView {host} {itemId} {pollMs} {onselect} {rowAside} />{/key}{/key}

package/dist/svelte/components/IntakeWorkspace.svelte.d.ts

@@ -0,0 +1,19 @@
+import type { Snippet } from 'svelte';
+import type { InboxEntry, IntakeReviewHost } from '../../review-dto.js';
+export interface Props {
+    host: IntakeReviewHost;
+    /** Replace whenever the authenticated tenant/session context changes. */
+    contextKey?: string;
+    /** Item to open first; afterwards the workspace owns the selection. */
+    itemId?: string;
+    /** Reload interval while an item's background stage is in flight. */
+    pollMs?: number;
+    /** Told about every selection change (e.g. to keep a URL in step); never navigates. */
+    onselect?: (itemId: string | undefined) => void;
+    /** Optional per-row aside (preview, original link); receives the page entry. */
+    rowAside?: Snippet<[InboxEntry]>;
+}
+declare const IntakeWorkspace: import("svelte").Component<Props, {}, "">;
+type IntakeWorkspace = ReturnType<typeof IntakeWorkspace>;
+export default IntakeWorkspace;
+//# sourceMappingURL=IntakeWorkspace.svelte.d.ts.map

package/dist/svelte/components/IntakeWorkspace.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntakeWorkspace.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/IntakeWorkspace.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGxE,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAChD,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CAClC;AAmBD,QAAA,MAAM,eAAe,2CAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}