@aventurevc/api-schemas 0.8.3 → 0.8.5

package/dist/identification/identification.d.ts

@@ -1,6 +1,19 @@
 import { z } from "zod/v4";
-declare const IdentificationSchemaDefinition: z.ZodObject<{
+/**
+ * Which existing company or person record a subject is, how that was settled, and the candidates considered, most probable first.
+ *
+ * @openapiSchema Identification
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
+ * @endpoint POST /v1/people/lookup
+ * @usedBySchema LookupJobMentionSchema
+ * @contractShape identification.identification
+ * @contractRole canonical
+ */
+export declare const IdentificationSchema: z.ZodObject<{
     candidate: z.ZodArray<z.ZodObject<{
+        dataCompletionCoverage: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         duplicateBasis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             JUDGED: "JUDGED";
             SHARED_FACT: "SHARED_FACT";
@@ -33,9 +46,11 @@ declare const IdentificationSchemaDefinition: z.ZodObject<{
             slug?: string | null | undefined;
             typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
         }, unknown>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     }, z.core.$strip>>;
     detail: z.ZodString;
     duplicate: z.ZodArray<z.ZodObject<{
+        dataCompletionCoverage: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         duplicateBasis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             JUDGED: "JUDGED";
             SHARED_FACT: "SHARED_FACT";
@@ -68,8 +83,10 @@ declare const IdentificationSchemaDefinition: z.ZodObject<{
             slug?: string | null | undefined;
             typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
         }, unknown>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     }, z.core.$strip>>;
     match: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        dataCompletionCoverage: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         duplicateBasis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             JUDGED: "JUDGED";
             SHARED_FACT: "SHARED_FACT";
@@ -102,6 +119,7 @@ declare const IdentificationSchemaDefinition: z.ZodObject<{
             slug?: string | null | undefined;
             typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
         }, unknown>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     }, z.core.$strip>>>;
     matchConfidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     matchEvidenceProbability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -117,18 +135,5 @@ declare const IdentificationSchemaDefinition: z.ZodObject<{
         NO_MATCH: "NO_MATCH";
     }>;
 }, z.core.$strip>;
-type IdentificationDefinition = z.infer<typeof IdentificationSchemaDefinition>;
-/**
- * Which existing company or person record a subject is, how that was settled, and the candidates considered, most probable first.
- *
- * @openapiSchema Identification
- * @endpoint POST /v1/entities/lookup
- * @endpoint POST /v1/lookup
- * @endpoint POST /v1/people/lookup
- * @contractShape identification.identification
- * @contractRole canonical
- */
-export declare const IdentificationSchema: z.ZodType<IdentificationDefinition>;
 export type Identification = z.infer<typeof IdentificationSchema>;
-export {};
 //# sourceMappingURL=identification.d.ts.map

package/dist/identification/identification.js

@@ -1,7 +1,19 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
 import { IdentificationCandidateSchema } from "./candidate.js";
-const IdentificationSchemaDefinition = z.object({
+/**
+ * Which existing company or person record a subject is, how that was settled, and the candidates considered, most probable first.
+ *
+ * @openapiSchema Identification
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
+ * @endpoint POST /v1/people/lookup
+ * @usedBySchema LookupJobMentionSchema
+ * @contractShape identification.identification
+ * @contractRole canonical
+ */
+export const IdentificationSchema = z.object({
     /** Records considered, most probable first. */
     candidate: z.array(IdentificationCandidateSchema),
     /** One sentence naming what settled the answer or what the user must decide. */
@@ -21,15 +33,4 @@ const IdentificationSchemaDefinition = z.object({
     /** What the caller does next: act on match, create, or ask the user. */
     status: z.enum(["MATCHED", "NO_MATCH", "NEEDS_REVIEW"]),
 });
-/**
- * Which existing company or person record a subject is, how that was settled, and the candidates considered, most probable first.
- *
- * @openapiSchema Identification
- * @endpoint POST /v1/entities/lookup
- * @endpoint POST /v1/lookup
- * @endpoint POST /v1/people/lookup
- * @contractShape identification.identification
- * @contractRole canonical
- */
-export const IdentificationSchema = IdentificationSchemaDefinition;
 //# sourceMappingURL=identification.js.map

package/dist/job/enqueue.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+declare const JobEnqueueSchemaDefinition: z.ZodObject<{
+    jobId: z.ZodUUID;
+    mode: z.ZodString;
+    statusUrl: z.ZodString;
+}, z.core.$strip>;
+type JobEnqueueDefinition = z.infer<typeof JobEnqueueSchemaDefinition>;
+/**
+ * Accepted asynchronous app job enqueue response.
+ *
+ * @openapiSchema JobEnqueue
+ * @endpoint POST /v1/lookup-jobs
+ * @contractShape job.enqueue
+ * @contractRole canonical
+ */
+export declare const JobEnqueueSchema: z.ZodType<JobEnqueueDefinition>;
+export type JobEnqueue = z.infer<typeof JobEnqueueSchema>;
+export {};
+//# sourceMappingURL=enqueue.d.ts.map

package/dist/job/enqueue.js

@@ -0,0 +1,18 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const JobEnqueueSchemaDefinition = z.object({
+    jobId: z.uuid(),
+    mode: z.string(),
+    /** Endpoint to poll for asynchronous job state and result. */
+    statusUrl: z.string(),
+});
+/**
+ * Accepted asynchronous app job enqueue response.
+ *
+ * @openapiSchema JobEnqueue
+ * @endpoint POST /v1/lookup-jobs
+ * @contractShape job.enqueue
+ * @contractRole canonical
+ */
+export const JobEnqueueSchema = JobEnqueueSchemaDefinition;
+//# sourceMappingURL=enqueue.js.map

package/dist/job/state.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+/**
+ * Shared lifecycle states for async jobs (duplicate-check, logo-audit, etc.)
+ *
+ * @openapiSchema JobState
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @usedBySchema LookupJobSchema
+ * @contractShape job.state
+ * @contractRole canonical
+ */
+export declare const JobStateSchema: z.ZodEnum<{
+    CANCELED: "CANCELED";
+    COMPLETED: "COMPLETED";
+    FAILED: "FAILED";
+    PENDING: "PENDING";
+    RUNNING: "RUNNING";
+    UNKNOWN: "UNKNOWN";
+}>;
+export type JobState = z.infer<typeof JobStateSchema>;
+//# sourceMappingURL=state.d.ts.map

package/dist/job/state.js

@@ -0,0 +1,20 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+/**
+ * Shared lifecycle states for async jobs (duplicate-check, logo-audit, etc.)
+ *
+ * @openapiSchema JobState
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @usedBySchema LookupJobSchema
+ * @contractShape job.state
+ * @contractRole canonical
+ */
+export const JobStateSchema = z.enum([
+    "PENDING",
+    "RUNNING",
+    "COMPLETED",
+    "FAILED",
+    "CANCELED",
+    "UNKNOWN",
+]);
+//# sourceMappingURL=state.js.map

package/dist/lookup/job-mention.d.ts

@@ -0,0 +1,152 @@
+import { z } from "zod/v4";
+declare const LookupJobMentionSchemaDefinition: z.ZodObject<{
+    failureReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    identification: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        candidate: z.ZodArray<z.ZodObject<{
+            dataCompletionCoverage: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            duplicateBasis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                JUDGED: "JUDGED";
+                SHARED_FACT: "SHARED_FACT";
+                STUB: "STUB";
+            }>>>;
+            duplicateProbability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            owner: z.ZodObject<{
+                entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+                personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            }, z.core.$strip>;
+            probability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            record: z.ZodType<{
+                externalId?: string | null | undefined;
+                id: string;
+                name?: string | null | undefined;
+                operatingStatus?: string | null | undefined;
+                publicPath?: string | null | undefined;
+                reason: string[];
+                score: number;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                externalId?: string | null | undefined;
+                id: string;
+                name?: string | null | undefined;
+                operatingStatus?: string | null | undefined;
+                publicPath?: string | null | undefined;
+                reason: string[];
+                score: number;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            }, unknown>>;
+            updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        }, z.core.$strip>>;
+        detail: z.ZodString;
+        duplicate: z.ZodArray<z.ZodObject<{
+            dataCompletionCoverage: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            duplicateBasis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                JUDGED: "JUDGED";
+                SHARED_FACT: "SHARED_FACT";
+                STUB: "STUB";
+            }>>>;
+            duplicateProbability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            owner: z.ZodObject<{
+                entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+                personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            }, z.core.$strip>;
+            probability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            record: z.ZodType<{
+                externalId?: string | null | undefined;
+                id: string;
+                name?: string | null | undefined;
+                operatingStatus?: string | null | undefined;
+                publicPath?: string | null | undefined;
+                reason: string[];
+                score: number;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                externalId?: string | null | undefined;
+                id: string;
+                name?: string | null | undefined;
+                operatingStatus?: string | null | undefined;
+                publicPath?: string | null | undefined;
+                reason: string[];
+                score: number;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            }, unknown>>;
+            updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        }, z.core.$strip>>;
+        match: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            dataCompletionCoverage: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            duplicateBasis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                JUDGED: "JUDGED";
+                SHARED_FACT: "SHARED_FACT";
+                STUB: "STUB";
+            }>>>;
+            duplicateProbability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            owner: z.ZodObject<{
+                entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+                personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            }, z.core.$strip>;
+            probability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            record: z.ZodType<{
+                externalId?: string | null | undefined;
+                id: string;
+                name?: string | null | undefined;
+                operatingStatus?: string | null | undefined;
+                publicPath?: string | null | undefined;
+                reason: string[];
+                score: number;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                externalId?: string | null | undefined;
+                id: string;
+                name?: string | null | undefined;
+                operatingStatus?: string | null | undefined;
+                publicPath?: string | null | undefined;
+                reason: string[];
+                score: number;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            }, unknown>>;
+            updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        }, z.core.$strip>>>;
+        matchConfidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        matchEvidenceProbability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        officialUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        stage: z.ZodEnum<{
+            DETERMINISTIC: "DETERMINISTIC";
+            JUDGMENT: "JUDGMENT";
+            WEB_EVIDENCE: "WEB_EVIDENCE";
+        }>;
+        status: z.ZodEnum<{
+            MATCHED: "MATCHED";
+            NEEDS_REVIEW: "NEEDS_REVIEW";
+            NO_MATCH: "NO_MATCH";
+        }>;
+    }, z.core.$strip>>>;
+    mentionType: z.ZodEnum<{
+        COMPANY: "COMPANY";
+        PERSON: "PERSON";
+    }>;
+    name: z.ZodString;
+    shell: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>>>;
+    shellDetail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type LookupJobMentionDefinition = z.infer<typeof LookupJobMentionSchemaDefinition>;
+/**
+ * One company or person the article names, which stored record it is, and the hidden shell record filed for it when it is new.
+ *
+ * @openapiSchema LookupJobMention
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @usedBySchema LookupJobSchema
+ * @contractShape lookup.job-mention
+ * @contractRole canonical
+ */
+export declare const LookupJobMentionSchema: z.ZodType<LookupJobMentionDefinition>;
+export type LookupJobMention = z.infer<typeof LookupJobMentionSchema>;
+export {};
+//# sourceMappingURL=job-mention.d.ts.map

package/dist/lookup/job-mention.js

@@ -0,0 +1,29 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
+import { IdentificationSchema } from "../identification/identification.js";
+const LookupJobMentionSchemaDefinition = z.object({
+    /** One sentence on why this name could not be identified; absent otherwise. */
+    failureReason: z.string().nullish(),
+    /** The lookup of this name with the article as its source: MATCHED names the stored record, NEEDS_REVIEW lists the candidates, NO_MATCH means none is stored. Absent when failureReason is set. */
+    identification: IdentificationSchema.nullish(),
+    /** Whether the article names a company or a person. */
+    mentionType: z.enum(["COMPANY", "PERSON"]),
+    /** Name as the article writes it. */
+    name: z.string(),
+    /** The hidden record this job created for a NO_MATCH name after the article and one independent live page both showed it exists; enrich it by its entityId or personId. Absent when no record was created. */
+    shell: EntityPersonOwnerSchema.nullish(),
+    /** One sentence on why no shell was created for a NO_MATCH name, or why a created shell lacks its URL; absent otherwise. */
+    shellDetail: z.string().nullish(),
+});
+/**
+ * One company or person the article names, which stored record it is, and the hidden shell record filed for it when it is new.
+ *
+ * @openapiSchema LookupJobMention
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @usedBySchema LookupJobSchema
+ * @contractShape lookup.job-mention
+ * @contractRole canonical
+ */
+export const LookupJobMentionSchema = LookupJobMentionSchemaDefinition;
+//# sourceMappingURL=job-mention.js.map

package/dist/lookup/job-mutation.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+declare const LookupJobMutationSchemaDefinition: z.ZodObject<{
+    sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type LookupJobMutationDefinition = z.infer<typeof LookupJobMutationSchemaDefinition>;
+/**
+ * The article whose companies and people a lookup job identifies. Send sourceUrl, sourceNewsId, or both.
+ *
+ * @openapiSchema LookupJobMutation
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/lookup-jobs
+ * @usedBySchema LookupJobSchema
+ * @contractShape lookup.job-mutation
+ * @contractRole canonical
+ */
+export declare const LookupJobMutationSchema: z.ZodType<LookupJobMutationDefinition>;
+export type LookupJobMutation = z.infer<typeof LookupJobMutationSchema>;
+export {};
+//# sourceMappingURL=job-mutation.d.ts.map

package/dist/lookup/job-mutation.js

@@ -0,0 +1,20 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const LookupJobMutationSchemaDefinition = z.object({
+    /** aVenture news id of the article; an unknown id fails the job. */
+    sourceNewsId: z.int().nullish(),
+    /** URL of the article; read from aVenture news when stored there, otherwise fetched. */
+    sourceUrl: z.string().max(2000).nullish(),
+});
+/**
+ * The article whose companies and people a lookup job identifies. Send sourceUrl, sourceNewsId, or both.
+ *
+ * @openapiSchema LookupJobMutation
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/lookup-jobs
+ * @usedBySchema LookupJobSchema
+ * @contractShape lookup.job-mutation
+ * @contractRole canonical
+ */
+export const LookupJobMutationSchema = LookupJobMutationSchemaDefinition;
+//# sourceMappingURL=job-mutation.js.map

package/dist/lookup/job.d.ts

@@ -0,0 +1,202 @@
+import { z } from "zod/v4";
+declare const LookupJobSchemaDefinition: z.ZodObject<{
+    createdAt: z.ZodISODateTime;
+    failureReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    jobId: z.ZodUUID;
+    mention: z.ZodArray<z.ZodType<{
+        failureReason?: string | null | undefined;
+        identification?: {
+            candidate: {
+                dataCompletionCoverage?: number | null | undefined;
+                duplicateBasis?: "JUDGED" | "SHARED_FACT" | "STUB" | null | undefined;
+                duplicateProbability?: number | null | undefined;
+                owner: {
+                    entityId?: string | null | undefined;
+                    personId?: string | null | undefined;
+                };
+                probability?: number | null | undefined;
+                record: {
+                    externalId?: string | null | undefined;
+                    id: string;
+                    name?: string | null | undefined;
+                    operatingStatus?: string | null | undefined;
+                    publicPath?: string | null | undefined;
+                    reason: string[];
+                    score: number;
+                    slug?: string | null | undefined;
+                    typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                };
+                updatedAt?: string | null | undefined;
+            }[];
+            detail: string;
+            duplicate: {
+                dataCompletionCoverage?: number | null | undefined;
+                duplicateBasis?: "JUDGED" | "SHARED_FACT" | "STUB" | null | undefined;
+                duplicateProbability?: number | null | undefined;
+                owner: {
+                    entityId?: string | null | undefined;
+                    personId?: string | null | undefined;
+                };
+                probability?: number | null | undefined;
+                record: {
+                    externalId?: string | null | undefined;
+                    id: string;
+                    name?: string | null | undefined;
+                    operatingStatus?: string | null | undefined;
+                    publicPath?: string | null | undefined;
+                    reason: string[];
+                    score: number;
+                    slug?: string | null | undefined;
+                    typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                };
+                updatedAt?: string | null | undefined;
+            }[];
+            match?: {
+                dataCompletionCoverage?: number | null | undefined;
+                duplicateBasis?: "JUDGED" | "SHARED_FACT" | "STUB" | null | undefined;
+                duplicateProbability?: number | null | undefined;
+                owner: {
+                    entityId?: string | null | undefined;
+                    personId?: string | null | undefined;
+                };
+                probability?: number | null | undefined;
+                record: {
+                    externalId?: string | null | undefined;
+                    id: string;
+                    name?: string | null | undefined;
+                    operatingStatus?: string | null | undefined;
+                    publicPath?: string | null | undefined;
+                    reason: string[];
+                    score: number;
+                    slug?: string | null | undefined;
+                    typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                };
+                updatedAt?: string | null | undefined;
+            } | null | undefined;
+            matchConfidence?: number | null | undefined;
+            matchEvidenceProbability?: number | null | undefined;
+            officialUrl?: string | null | undefined;
+            stage: "DETERMINISTIC" | "JUDGMENT" | "WEB_EVIDENCE";
+            status: "MATCHED" | "NEEDS_REVIEW" | "NO_MATCH";
+        } | null | undefined;
+        mentionType: "COMPANY" | "PERSON";
+        name: string;
+        shell?: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        } | null | undefined;
+        shellDetail?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        failureReason?: string | null | undefined;
+        identification?: {
+            candidate: {
+                dataCompletionCoverage?: number | null | undefined;
+                duplicateBasis?: "JUDGED" | "SHARED_FACT" | "STUB" | null | undefined;
+                duplicateProbability?: number | null | undefined;
+                owner: {
+                    entityId?: string | null | undefined;
+                    personId?: string | null | undefined;
+                };
+                probability?: number | null | undefined;
+                record: {
+                    externalId?: string | null | undefined;
+                    id: string;
+                    name?: string | null | undefined;
+                    operatingStatus?: string | null | undefined;
+                    publicPath?: string | null | undefined;
+                    reason: string[];
+                    score: number;
+                    slug?: string | null | undefined;
+                    typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                };
+                updatedAt?: string | null | undefined;
+            }[];
+            detail: string;
+            duplicate: {
+                dataCompletionCoverage?: number | null | undefined;
+                duplicateBasis?: "JUDGED" | "SHARED_FACT" | "STUB" | null | undefined;
+                duplicateProbability?: number | null | undefined;
+                owner: {
+                    entityId?: string | null | undefined;
+                    personId?: string | null | undefined;
+                };
+                probability?: number | null | undefined;
+                record: {
+                    externalId?: string | null | undefined;
+                    id: string;
+                    name?: string | null | undefined;
+                    operatingStatus?: string | null | undefined;
+                    publicPath?: string | null | undefined;
+                    reason: string[];
+                    score: number;
+                    slug?: string | null | undefined;
+                    typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                };
+                updatedAt?: string | null | undefined;
+            }[];
+            match?: {
+                dataCompletionCoverage?: number | null | undefined;
+                duplicateBasis?: "JUDGED" | "SHARED_FACT" | "STUB" | null | undefined;
+                duplicateProbability?: number | null | undefined;
+                owner: {
+                    entityId?: string | null | undefined;
+                    personId?: string | null | undefined;
+                };
+                probability?: number | null | undefined;
+                record: {
+                    externalId?: string | null | undefined;
+                    id: string;
+                    name?: string | null | undefined;
+                    operatingStatus?: string | null | undefined;
+                    publicPath?: string | null | undefined;
+                    reason: string[];
+                    score: number;
+                    slug?: string | null | undefined;
+                    typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                };
+                updatedAt?: string | null | undefined;
+            } | null | undefined;
+            matchConfidence?: number | null | undefined;
+            matchEvidenceProbability?: number | null | undefined;
+            officialUrl?: string | null | undefined;
+            stage: "DETERMINISTIC" | "JUDGMENT" | "WEB_EVIDENCE";
+            status: "MATCHED" | "NEEDS_REVIEW" | "NO_MATCH";
+        } | null | undefined;
+        mentionType: "COMPANY" | "PERSON";
+        name: string;
+        shell?: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        } | null | undefined;
+        shellDetail?: string | null | undefined;
+    }, unknown>>>;
+    source: z.ZodType<{
+        sourceNewsId?: number | null | undefined;
+        sourceUrl?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        sourceNewsId?: number | null | undefined;
+        sourceUrl?: string | null | undefined;
+    }, unknown>>;
+    state: z.ZodEnum<{
+        CANCELED: "CANCELED";
+        COMPLETED: "COMPLETED";
+        FAILED: "FAILED";
+        PENDING: "PENDING";
+        RUNNING: "RUNNING";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type LookupJobDefinition = z.infer<typeof LookupJobSchemaDefinition>;
+/**
+ * An async lookup job's state and, once COMPLETED, every company and person the article names, each identified against stored records.
+ *
+ * @openapiSchema LookupJob
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @contractShape lookup.job
+ * @contractRole canonical
+ */
+export declare const LookupJobSchema: z.ZodType<LookupJobDefinition>;
+export type LookupJob = z.infer<typeof LookupJobSchema>;
+export {};
+//# sourceMappingURL=job.d.ts.map

package/dist/lookup/job.js

@@ -0,0 +1,31 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { JobStateSchema } from "../job/state.js";
+import { LookupJobMentionSchema } from "./job-mention.js";
+import { LookupJobMutationSchema } from "./job-mutation.js";
+const LookupJobSchemaDefinition = z.object({
+    /** When the job was requested. */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** Why the job failed; absent unless state is FAILED. */
+    failureReason: z.string().nullish(),
+    /** Lookup job id. */
+    jobId: z.uuid(),
+    /** Each distinct company and person the article names; empty until COMPLETED. */
+    mention: z.array(LookupJobMentionSchema),
+    /** The article the job reads. */
+    source: LookupJobMutationSchema,
+    /** Current job state. */
+    state: JobStateSchema,
+    /** When the job last changed state. */
+    updatedAt: z.iso.datetime({ offset: true }),
+});
+/**
+ * An async lookup job's state and, once COMPLETED, every company and person the article names, each identified against stored records.
+ *
+ * @openapiSchema LookupJob
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @contractShape lookup.job
+ * @contractRole canonical
+ */
+export const LookupJobSchema = LookupJobSchemaDefinition;
+//# sourceMappingURL=job.js.map