@empressaio/atom-contract 1.15.0 → 1.16.0

package/dist/property/owner-fact.d.ts

@@ -0,0 +1,698 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import type { AtomTier } from "../conformance/common.js";
+import type { ReasoningChain } from "../reasoning-chain.js";
+import type { ReasoningReadContract } from "../read-contract/reasoning-axes.js";
+import { type CadRollSourceTier, type OwnerFactAbsence, type SiteLayerVerifiedAbsence } from "./common.js";
+/**
+ * Owner FACT atom — CAD `owner_name` + mailing address, or honest absence.
+ *
+ * THE POLICY CAME FIRST AND THE CARRIER CAME LAST. Owner was ruled
+ * `public-paid` at the atom level long before any owner atom existed, so the
+ * county manifest's OWN rail has been reading `NO ATOM` over a store that
+ * already holds 4.5M owner rows (`cad_property.owner_name`, 98.4% populated
+ * across 15 counties as of 2026-08-09). This type is the carrier that ruling
+ * always presumed. See doc_repo `90_operations/OPS-15_owner_and_rrc_rail_gap_
+ * analysis.md`.
+ *
+ * WHY THIS IS THE ONLY `public-paid` PROPERTY ATOM. Every sibling in this
+ * module pins `public-free` in its superRefine. Owner is the deliberate
+ * exception and the schema enforces it in the same shape: an owner-fact that
+ * tries to ship `public-free` fails to parse. The policy therefore cannot be
+ * lost by a careless writer — it is structural, not conventional.
+ *
+ * PRIVACY POSTURE (doc_repo OPS-15 R4). Owner name plus mailing address on
+ * Texas parcels is public record and lawful to serve, but it is the most
+ * privacy-sensitive facet in the catalog. Two deliberate constraints:
+ *
+ *   1. `exemptionFlags` carries BOOLEAN FLAGS, never raw exemption codes.
+ *      Homestead and over-65/disability exemption codes imply occupancy and
+ *      household composition; a flag answers the underwriting question
+ *      ("is this owner-occupied?") without republishing the code that
+ *      implies who lives there.
+ *   2. `ownerMailingAddress` is optional and independently omittable, so a
+ *      serving tier can carry the name without the mailing address.
+ *
+ * Cotality is extinguished — owner data comes from the CAD roll only. Never
+ * add a cotality sourceTier.
+ */
+export interface OwnerFactAtomInstance {
+    entityType: "owner-fact";
+    atomDid: string;
+    parcelNodeId: string;
+    taxYear: number;
+    reasoningChain: Extract<ReasoningChain, {
+        reasoningKind: "observed";
+    }>;
+    sourceTier: CadRollSourceTier;
+    ownerName?: string;
+    ownerMailingAddress?: string;
+    /**
+     * Boolean flags derived from CAD `exemption_codes`, never the raw codes.
+     * Absent when the roll carries no exemption data for the parcel.
+     */
+    exemptionFlags?: OwnerExemptionFlags;
+    absence?: OwnerFactAbsence;
+    verifiedAbsence?: SiteLayerVerifiedAbsence;
+    accessPolicy: AccessPolicy;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    sourceVintage?: string;
+    verificationStatus: "machine" | "human" | "unsurveyed";
+    sourceAdapter: string;
+    evaluatedAt: string;
+    atomTier: AtomTier;
+    readContract?: ReasoningReadContract;
+}
+export declare const OWNER_EXEMPTION_FLAGS_SCHEMA: z.ZodObject<{
+    /** Any homestead exemption present — implies owner-occupied. */
+    homestead: z.ZodBoolean;
+    /** Over-65 or disability exemption present. */
+    seniorOrDisability: z.ZodBoolean;
+    /** Agricultural / open-space / timber valuation present. */
+    agricultural: z.ZodBoolean;
+    /** Veteran exemption present. */
+    veteran: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    homestead: boolean;
+    seniorOrDisability: boolean;
+    agricultural: boolean;
+    veteran: boolean;
+}, {
+    homestead: boolean;
+    seniorOrDisability: boolean;
+    agricultural: boolean;
+    veteran: boolean;
+}>;
+export type OwnerExemptionFlags = z.infer<typeof OWNER_EXEMPTION_FLAGS_SCHEMA>;
+export declare const OWNER_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
+    atomTier: z.ZodLiteral<AtomTier>;
+    readContract: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        axes: z.ZodReadonly<z.ZodObject<{
+            calibratedConfidence: z.ZodReadonly<z.ZodObject<{
+                readonly estimate: z.ZodNumber;
+                readonly n: z.ZodNumber;
+                readonly intervalWidth: z.ZodNumber;
+                readonly provenance: z.ZodEnum<["asserted", "backtest", "seed", "live"]>;
+            }, "strip", z.ZodTypeAny, {
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }, {
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>>;
+            assertedConfidence: z.ZodReadonly<z.ZodObject<{
+                readonly estimate: z.ZodNumber;
+                readonly n: z.ZodNumber;
+                readonly intervalWidth: z.ZodNumber;
+                readonly provenance: z.ZodEnum<["asserted", "backtest", "seed", "live"]>;
+            }, "strip", z.ZodTypeAny, {
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }, {
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>>;
+            consequence: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"property-risk">;
+                stratum: z.ZodEnum<[import("../read-contract/reasoning-axes.js").PropertyRiskStratum, ...import("../read-contract/reasoning-axes.js").PropertyRiskStratum[]]>;
+                basis: z.ZodString;
+                assertedAt: z.ZodString;
+                auditRef: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            }, {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"not-applicable">;
+                reason: z.ZodString;
+                assertedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            }, {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }, {
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }>>;
+        assembledAt: z.ZodString;
+        modelAttribution: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+            modelId: z.ZodString;
+            modelVersion: z.ZodString;
+            promptTemplateVersion: z.ZodString;
+            contextTemplateVersion: z.ZodString;
+            samplingParams: z.ZodReadonly<z.ZodObject<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodUnknown, z.objectOutputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">, z.objectInputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>>;
+            retrievedAtomSetId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectOutputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }, {
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectInputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        axes: Readonly<{
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }>;
+        assembledAt: string;
+        modelAttribution?: Readonly<{
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectOutputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }> | undefined;
+    }, {
+        axes: Readonly<{
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }>;
+        assembledAt: string;
+        modelAttribution?: Readonly<{
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectInputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }> | undefined;
+    }>>>;
+    sourceVintage: z.ZodOptional<z.ZodString>;
+    verificationStatus: z.ZodEnum<["machine", "human", "unsurveyed"]>;
+    sourceAdapter: z.ZodString;
+    evaluatedAt: z.ZodString;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodLiteral<"owner-fact">;
+    atomDid: z.ZodEffects<z.ZodString, string, string>;
+    parcelNodeId: z.ZodEffects<z.ZodString, string, string>;
+    taxYear: z.ZodNumber;
+    reasoningChain: z.ZodObject<{
+        reasoningKind: z.ZodLiteral<"observed">;
+    }, "strip", z.ZodTypeAny, {
+        reasoningKind: "observed";
+    }, {
+        reasoningKind: "observed";
+    }>;
+    sourceTier: z.ZodEnum<["cad-authoritative", "absent"]>;
+    ownerName: z.ZodOptional<z.ZodString>;
+    ownerMailingAddress: z.ZodOptional<z.ZodString>;
+    exemptionFlags: z.ZodOptional<z.ZodObject<{
+        /** Any homestead exemption present — implies owner-occupied. */
+        homestead: z.ZodBoolean;
+        /** Over-65 or disability exemption present. */
+        seniorOrDisability: z.ZodBoolean;
+        /** Agricultural / open-space / timber valuation present. */
+        agricultural: z.ZodBoolean;
+        /** Veteran exemption present. */
+        veteran: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        homestead: boolean;
+        seniorOrDisability: boolean;
+        agricultural: boolean;
+        veteran: boolean;
+    }, {
+        homestead: boolean;
+        seniorOrDisability: boolean;
+        agricultural: boolean;
+        veteran: boolean;
+    }>>;
+    absence: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<["no-owner-name", "owner-withheld", "no-cad-row", "join-hold"]>;
+        reason: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "no-cad-row" | "join-hold" | "no-owner-name" | "owner-withheld";
+        reason: string;
+    }, {
+        kind: "no-cad-row" | "join-hold" | "no-owner-name" | "owner-withheld";
+        reason: string;
+    }>>;
+    verifiedAbsence: z.ZodOptional<z.ZodObject<{
+        evaluated: z.ZodLiteral<true>;
+        provenanceScope: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        evaluated: true;
+        provenanceScope: string[];
+    }, {
+        evaluated: true;
+        provenanceScope: string[];
+    }>>;
+    accessPolicy: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "owner-fact";
+    sourceCitation: string;
+    extractedAt: string;
+    atomDid: string;
+    evaluatedAt: string;
+    verificationStatus: "machine" | "human" | "unsurveyed";
+    sourceAdapter: string;
+    parcelNodeId: string;
+    reasoningChain: {
+        reasoningKind: "observed";
+    };
+    atomTier: AtomTier;
+    sourceTier: "cad-authoritative" | "absent";
+    taxYear: number;
+    asOf?: string | undefined;
+    readContract?: Readonly<{
+        axes: Readonly<{
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }>;
+        assembledAt: string;
+        modelAttribution?: Readonly<{
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectOutputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }> | undefined;
+    }> | undefined;
+    absence?: {
+        kind: "no-cad-row" | "join-hold" | "no-owner-name" | "owner-withheld";
+        reason: string;
+    } | undefined;
+    verifiedAbsence?: {
+        evaluated: true;
+        provenanceScope: string[];
+    } | undefined;
+    sourceVintage?: string | undefined;
+    ownerName?: string | undefined;
+    ownerMailingAddress?: string | undefined;
+    exemptionFlags?: {
+        homestead: boolean;
+        seniorOrDisability: boolean;
+        agricultural: boolean;
+        veteran: boolean;
+    } | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "owner-fact";
+    sourceCitation: string;
+    extractedAt: string;
+    atomDid: string;
+    evaluatedAt: string;
+    verificationStatus: "machine" | "human" | "unsurveyed";
+    sourceAdapter: string;
+    parcelNodeId: string;
+    reasoningChain: {
+        reasoningKind: "observed";
+    };
+    atomTier: AtomTier;
+    sourceTier: "cad-authoritative" | "absent";
+    taxYear: number;
+    asOf?: string | undefined;
+    readContract?: Readonly<{
+        axes: Readonly<{
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }>;
+        assembledAt: string;
+        modelAttribution?: Readonly<{
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectInputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }> | undefined;
+    }> | undefined;
+    absence?: {
+        kind: "no-cad-row" | "join-hold" | "no-owner-name" | "owner-withheld";
+        reason: string;
+    } | undefined;
+    verifiedAbsence?: {
+        evaluated: true;
+        provenanceScope: string[];
+    } | undefined;
+    sourceVintage?: string | undefined;
+    ownerName?: string | undefined;
+    ownerMailingAddress?: string | undefined;
+    exemptionFlags?: {
+        homestead: boolean;
+        seniorOrDisability: boolean;
+        agricultural: boolean;
+        veteran: boolean;
+    } | undefined;
+}>, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "owner-fact";
+    sourceCitation: string;
+    extractedAt: string;
+    atomDid: string;
+    evaluatedAt: string;
+    verificationStatus: "machine" | "human" | "unsurveyed";
+    sourceAdapter: string;
+    parcelNodeId: string;
+    reasoningChain: {
+        reasoningKind: "observed";
+    };
+    atomTier: AtomTier;
+    sourceTier: "cad-authoritative" | "absent";
+    taxYear: number;
+    asOf?: string | undefined;
+    readContract?: Readonly<{
+        axes: Readonly<{
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }>;
+        assembledAt: string;
+        modelAttribution?: Readonly<{
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectOutputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }> | undefined;
+    }> | undefined;
+    absence?: {
+        kind: "no-cad-row" | "join-hold" | "no-owner-name" | "owner-withheld";
+        reason: string;
+    } | undefined;
+    verifiedAbsence?: {
+        evaluated: true;
+        provenanceScope: string[];
+    } | undefined;
+    sourceVintage?: string | undefined;
+    ownerName?: string | undefined;
+    ownerMailingAddress?: string | undefined;
+    exemptionFlags?: {
+        homestead: boolean;
+        seniorOrDisability: boolean;
+        agricultural: boolean;
+        veteran: boolean;
+    } | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "owner-fact";
+    sourceCitation: string;
+    extractedAt: string;
+    atomDid: string;
+    evaluatedAt: string;
+    verificationStatus: "machine" | "human" | "unsurveyed";
+    sourceAdapter: string;
+    parcelNodeId: string;
+    reasoningChain: {
+        reasoningKind: "observed";
+    };
+    atomTier: AtomTier;
+    sourceTier: "cad-authoritative" | "absent";
+    taxYear: number;
+    asOf?: string | undefined;
+    readContract?: Readonly<{
+        axes: Readonly<{
+            calibratedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            assertedConfidence: Readonly<{
+                estimate: number;
+                n: number;
+                intervalWidth: number;
+                provenance: "asserted" | "backtest" | "seed" | "live";
+            }>;
+            consequence: {
+                stratum: import("../read-contract/reasoning-axes.js").PropertyRiskStratum;
+                assertedAt: string;
+                kind: "property-risk";
+                basis: string;
+                auditRef?: string | undefined;
+            } | {
+                assertedAt: string;
+                kind: "not-applicable";
+                reason: string;
+            };
+        }>;
+        assembledAt: string;
+        modelAttribution?: Readonly<{
+            modelId: string;
+            modelVersion: string;
+            promptTemplateVersion: string;
+            contextTemplateVersion: string;
+            samplingParams: Readonly<z.objectInputType<{
+                temperature: z.ZodOptional<z.ZodNumber>;
+                topP: z.ZodOptional<z.ZodNumber>;
+                maxTokens: z.ZodOptional<z.ZodNumber>;
+                seed: z.ZodOptional<z.ZodNumber>;
+            }, z.ZodUnknown, "strip">>;
+            retrievedAtomSetId: string;
+        }> | undefined;
+    }> | undefined;
+    absence?: {
+        kind: "no-cad-row" | "join-hold" | "no-owner-name" | "owner-withheld";
+        reason: string;
+    } | undefined;
+    verifiedAbsence?: {
+        evaluated: true;
+        provenanceScope: string[];
+    } | undefined;
+    sourceVintage?: string | undefined;
+    ownerName?: string | undefined;
+    ownerMailingAddress?: string | undefined;
+    exemptionFlags?: {
+        homestead: boolean;
+        seniorOrDisability: boolean;
+        agricultural: boolean;
+        veteran: boolean;
+    } | undefined;
+}>;
+export declare function createOwnerFact(input: z.input<typeof OWNER_FACT_SCHEMA>): OwnerFactAtomInstance;
+//# sourceMappingURL=owner-fact.d.ts.map