@kontourai/survey 1.6.1 → 1.7.0

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export type { CandidateSetStatus, Candidate, CandidateSet, ClaimTarget, EscalationDimension, EscalationRecord, Extraction, Interpretation, LocatorScheme, RawSource, RawSourceKind, ReviewAuthorizing, ReviewAuthorizingAuthorizedAction, ReviewAuthorizingExchange, ReviewAuthorizingExplicitStatement, ReviewAuthorizingKind, ReviewOutcome, ReviewStatus, SurveyInput, } from "./types.js";
+export type { CandidateSetStatus, Candidate, CandidateSet, ClaimTarget, EscalationDimension, EscalationRecord, Extraction, Interpretation, LocatorScheme, ProvenanceResolution, RawSource, RawSourceKind, ReviewAuthorizing, ReviewAuthorizingAuthorizedAction, ReviewAuthorizingExchange, ReviewAuthorizingExplicitStatement, ReviewAuthorizingKind, ReviewOutcome, ReviewStatus, SurveyInput, } from "./types.js";
 export { SURVEY_INPUT_CONTRACT_VERSION } from "./types.js";
 export { reviewResourceApiVersion } from "./review-resource.js";
 export type { CandidateRole, ClaimTargetHint, ProducerPolicy, ExtractionReference, ResourceEnvelope, ResourceMetadata, ReviewActor, ReviewCandidate, ReviewDecision, ReviewDecisionMode, ReviewDecisionSpec, ReviewDecisionStatus, ReviewItem, ReviewItemSpec, ReviewItemStatus, ReviewLocator, ReviewResource, ReviewResourceApiVersion, ReviewResourceKind, ReviewSession, ReviewSessionEvent, ReviewSessionEventSpec, ReviewSessionEventStatus, ReviewSessionEventType, ReviewSessionSpec, ReviewSessionStatus, SourceReference, SurveyRecordProjectionHint, } from "./review-resource.js";

package/dist/src/raw-source.d.ts

@@ -1,4 +1,4 @@
-import type { LocatorScheme, RawSource } from "./types.js";
+import type { LocatorScheme, ProvenanceResolution, RawSource } from "./types.js";
 export type ChecksumInput = string | {
     algorithm?: string;
     value: string;
@@ -7,6 +7,7 @@ export interface RawSourceInput {
     id?: string;
     sourceRef: string;
     observedAt: string;
+    resolution?: ProvenanceResolution;
     fetchedAt?: string;
     checksum?: ChecksumInput;
     locatorScheme: LocatorScheme;

package/dist/src/raw-source.js

@@ -60,6 +60,7 @@ function rawSource(kind, input) {
     return {
         id: input.id ?? sourceId(kind, input.sourceRef),
         kind,
+        resolution: input.resolution,
         sourceRef: input.sourceRef,
         observedAt: input.observedAt,
         fetchedAt: input.fetchedAt,

package/dist/src/to-surface.js

@@ -66,7 +66,7 @@ export function buildSurveyTrustBundle(input, options = {}) {
         evidence.push({
             id: evidenceId,
             claimId: projection.id,
-            evidenceType: projection.evidenceType ?? evidenceTypeFor(rawSource),
+            evidenceType: projection.evidenceType ?? (rawSource.resolution ? evidenceTypeForResolution(rawSource, rawSource.resolution) : evidenceTypeFor(rawSource)),
             method: projection.evidenceMethod ?? "extraction",
             sourceRef: rawSource.sourceRef,
             sourceLocator: extraction.locator,
@@ -81,6 +81,7 @@ export function buildSurveyTrustBundle(input, options = {}) {
                 ...(policyStandard ? { policyStandard } : {}),
                 rawSourceKind: rawSource.kind,
                 locatorScheme: rawSource.locatorScheme,
+                ...(rawSource.resolution ? { provenanceResolution: rawSource.resolution } : {}),
                 confidence: candidate.confidence ?? extraction.confidence,
             },
         });
@@ -364,6 +365,36 @@ function evidenceTypeFor(rawSource) {
         return "crawl_observation";
     return "attestation";
 }
+function evidenceTypeForResolution(rawSource, resolution) {
+    switch (resolution) {
+        case "testimony":
+        case "supersession":
+            return "attestation";
+        case "observation":
+            return rawSource.kind === "web-page" ? "crawl_observation" : "source_excerpt";
+        case "extraction":
+            return evidenceTypeForOrigin(rawSource.kind);
+        case "precedence-selection":
+        case "carry-forward":
+            return evidenceTypeForOrigin(rawSource.kind);
+        default:
+            return assertNever(resolution);
+    }
+}
+function evidenceTypeForOrigin(kind) {
+    if (kind === "policy-standard")
+        return "policy_rule";
+    if (kind === "uploaded-document")
+        return "document_citation";
+    if (kind === "web-page")
+        return "crawl_observation";
+    if (kind === "manual-entry")
+        return "attestation";
+    return "source_excerpt";
+}
+function assertNever(value) {
+    throw new Error(`Unsupported provenance resolution: ${String(value)}`);
+}
 function policyStandardFields(rawSource) {
     const metadata = rawSource.metadata?.policyStandard;
     const metadataRecord = isRecord(metadata) ? metadata : {};

package/dist/src/types.d.ts

@@ -1,9 +1,11 @@
 import type { ConfidenceBasis, DerivationEdge, EvidenceMethod, EvidenceType, ImpactLevel, TrustStatus } from "@kontourai/surface";
 export type RawSourceKind = "uploaded-document" | "web-page" | "api-record" | "manual-entry" | "policy-standard" | "inquiry-question" | "agent-utterance" | "system-schema";
+export type ProvenanceResolution = "extraction" | "testimony" | "supersession" | "precedence-selection" | "carry-forward" | "observation";
 export type LocatorScheme = "pdf" | "text" | "html" | "structured-field" | "text-span";
 export interface RawSource {
     id: string;
     kind: RawSourceKind;
+    resolution?: ProvenanceResolution;
     sourceRef: string;
     observedAt: string;
     fetchedAt?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/survey",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "description": "Producer-side source, extraction, candidate, and review contracts for projecting verified claims into Surface.",
   "license": "Apache-2.0",
   "type": "module",