@thehammer/template-verification 0.2.15 → 0.2.16

package/dist/types.d.ts

@@ -7,7 +7,6 @@
  * A rendered object node carries a `__meta` MAP keyed by leaf field name; each
  * entry is a {@link DataPointMeta} describing that one field's verification state.
  */
-import type { PreviewFile } from "@thehammer/danx-ui";
 /**
  * Status bucket derived from the integer 1-5 confidence (orthogonal to discrepancy),
  * plus 'failed' (SG-189) — a distinct extraction/citation-correction OUTCOME, not a
@@ -20,45 +19,69 @@ export type ResolvedSource = "override" | "extracted" | "claim" | "none";
 /** The basis a user picked when saving an override. */
 export type SourceChoice = "extracted" | "claim" | "custom";
 /**
- * One citation source for an extracted candidate. The live host shape carries
- * `id`/`source_type`/`stored_file_id`/`explanation`; the optional `file_*`/`page`
- * fields cover the idealized document-page shape. Grouping + linking tolerate
- * either: group by file identity, link only when `file_url` is present.
+ * One citation source for an extracted candidate — `CitationSourceResource`-shaped (SG-685),
+ * the SAME shape gpt-manager's session-authed `data-point-sources`/`data-point-history`
+ * endpoints already returned before this card promoted the token-sealed detail endpoint (and
+ * `history[]`) onto it too. Replaces the earlier `file`/`original_file`/`page_number`/
+ * `source_id`/`agent_thread_message_id` shape (`TemplateDataResource::sourcesPayload()`/
+ * `sourceFilePayload()`, deleted) — one citation transport, not two.
  */
 export interface VerificationSource {
     id?: number | string;
     source_type?: string | null;
-    source_id?: number | string | null;
     explanation?: string | null;
-    stored_file_id?: number | string | null;
-    agent_thread_message_id?: number | string | null;
     /**
      * Ordered verbatim snippets cited on this source's page (SG-181 — replaces the
      * retired attribute-level `cited_text` column). Empty only when the page has no
      * text transcript at all (image-only).
      */
     texts?: string[] | null;
-    file_id?: number | string;
-    page?: number;
-    file_url?: string;
-    file_name?: string;
-    /**
-     * The resolved StoredFile behind `stored_file_id`, danx-ui `PreviewFile`-shaped
-     * (id/name/size/mime/url/thumb?). Present when the host resolved it (gpt-manager's
-     * `TemplateDataResource::sourceFilePayload`); null/absent when the source has no
-     * linked file. This is what the modal renders a real thumbnail/preview from.
-     */
-    file?: PreviewFile | null;
-    /** The page's position inside its parent document (from the transcode StoredFile). */
-    page_number?: number | null;
+    /** Whether this citation resolved to a real page (or, for a `field` citation, a real
+     *  cited attribute). `false` reports WHY via `unresolved_reason` rather than a silent gap. */
+    resolved?: boolean;
+    unresolved_reason?: string | null;
+    stored_file_id?: number | string | null;
+    /** The rendered PAGE this source cites. Null when unresolved, or not a document citation. */
+    page?: {
+        id: string;
+        page_number: number | null;
+        url: string | null;
+        thumb_url: string | null;
+        mime: string | null;
+        size: number | null;
+    } | null;
+    /** The FULL document the cited page was rendered from, reached through the page's own
+     *  parent. Null when `page` is null. */
+    document?: {
+        id: string;
+        name: string | null;
+        url: string | null;
+        mime: string | null;
+    } | null;
+    /** Present only for a `field`-type citation (Generate Artifact) that resolved — the OTHER
+     *  field this value was drawn from, never a document. Null for every other source_type. */
+    field?: {
+        team_object_id: number;
+        field: string;
+        value: unknown;
+        confidence: number | null;
+        reasoning: string | null;
+        state: string | null;
+        superseded: boolean;
+        record_deleted: boolean;
+    } | null;
+    /** The LLM call (ApiLog id) that produced this citation. */
+    api_log_id?: number | string | null;
+    created_at?: string | null;
     /**
-     * The FULL parent document the cited page was transcoded from (PreviewFile-
-     * shaped; `url` is the whole PDF). Null when the source file is not a
-     * transcode page. Drives the Inspector's "view full document" drill-down.
+     * `CitationSourceResource extends` danx's `ActionResource`, which auto-prepends these three
+     * envelope keys to every `::collection()` call — a real, always-present part of the wire
+     * shape (unlike the retired `sourcesPayload()`, a plain array that never carried them), not
+     * something this library's own components read.
      */
-    original_file?: PreviewFile | null;
-    /** The LLM call (ApiLog id) that produced this citation, via the source message. */
-    api_log_id?: number | string | null;
+    __type?: string;
+    __timestamp?: number;
+    __deleted_at?: string | null;
 }
 /**
  * One piece of evidence a {@link SourceDiscrepancy} cites — the page a conflicting value
@@ -244,6 +267,12 @@ export interface HumanCitation {
  * machine reading. Null/absent on every override that did not opt in.
  */
 export interface OverrideCandidate {
+    /**
+     * The decisive human reading's own id (SG-685) — matches this exact row's `id` in
+     * gpt-manager's `data-point-history` response, letting a consumer find this candidate's own
+     * citations there rather than re-deriving which reading is decisive.
+     */
+    reading_id?: number;
     value: unknown;
     state?: "present" | "absent" | "removed" | null;
     set_by?: number | string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/template-verification",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "Read-write verification overlay for rendered template apps — per-data-point confidence, discrepancy, 3-source resolution (override > extracted > claim), inline edit, and a recursive comparison page. Consumes the host's __meta sidecar; fetches nothing.",
   "license": "MIT",
   "type": "module",