@aventurevc/api-schemas 0.8.3 → 0.8.6

package/dist/harness/run-lane.js

@@ -4,6 +4,8 @@ import { z } from "zod/v4";
  * Queue lane for admission priority: interactive client work vs background backlog
  *
  * @openapiSchema HarnessRunLane
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
  * @endpoint POST /v1/people/{personId}/enrichments
  * @usedBySchema HarnessRunSchema

package/dist/harness/run-progress.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+/**
+ * Current public progress of a harness run
+ *
+ * @openapiSchema HarnessRunProgress
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape harness.run-progress
+ * @contractRole canonical
+ */
+export declare const HarnessRunProgressSchema: z.ZodObject<{
+    complete: z.ZodBoolean;
+    entitySlug: z.ZodNullable<z.ZodString>;
+    gateRemaining: z.ZodArray<z.ZodString>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    whatElseRemaining: z.ZodArray<z.ZodString>;
+    writeThisIteration: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type HarnessRunProgress = z.infer<typeof HarnessRunProgressSchema>;
+//# sourceMappingURL=run-progress.d.ts.map

package/dist/harness/run-progress.js

@@ -0,0 +1,30 @@
+// 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";
+/**
+ * Current public progress of a harness run
+ *
+ * @openapiSchema HarnessRunProgress
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape harness.run-progress
+ * @contractRole canonical
+ */
+export const HarnessRunProgressSchema = z.object({
+    /** Whether the enrichment loop reports completion */
+    complete: z.boolean(),
+    /** Canonical entity slug currently reported by the loop */
+    entitySlug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255)
+        .nullable(),
+    /** Concrete completion gates that remain unmet */
+    gateRemaining: z.array(z.string()),
+    /** Optional progress note from the loop */
+    note: z.string().nullish(),
+    /** Additional work the loop reports as remaining */
+    whatElseRemaining: z.array(z.string()),
+    /** Writes completed during the current loop iteration */
+    writeThisIteration: z.array(z.string()),
+});
+//# sourceMappingURL=run-progress.js.map

package/dist/harness/run-status.d.ts

@@ -3,6 +3,8 @@ import { z } from "zod/v4";
  * Harness run lifecycle state
  *
  * @openapiSchema HarnessRunStatus
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
  * @endpoint POST /v1/people/{personId}/enrichments
  * @usedBySchema HarnessRunSchema

package/dist/harness/run-status.js

@@ -4,6 +4,8 @@ import { z } from "zod/v4";
  * Harness run lifecycle state
  *
  * @openapiSchema HarnessRunStatus
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
  * @endpoint POST /v1/people/{personId}/enrichments
  * @usedBySchema HarnessRunSchema

package/dist/harness/run-type.d.ts

@@ -3,6 +3,8 @@ import { z } from "zod/v4";
  * Harness run kind: full enrichment loop or bounded micro-task
  *
  * @openapiSchema HarnessRunType
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
  * @endpoint POST /v1/people/{personId}/enrichments
  * @usedBySchema HarnessRunSchema

package/dist/harness/run-type.js

@@ -4,6 +4,8 @@ import { z } from "zod/v4";
  * Harness run kind: full enrichment loop or bounded micro-task
  *
  * @openapiSchema HarnessRunType
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
  * @endpoint POST /v1/people/{personId}/enrichments
  * @usedBySchema HarnessRunSchema

package/dist/harness/run.d.ts

@@ -1,5 +1,18 @@
 import { z } from "zod/v4";
-declare const HarnessRunSchemaDefinition: z.ZodObject<{
+/**
+ * One harness enrichment run
+ *
+ * @openapiSchema HarnessRun
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint POST /v1/enrichments
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema EnrichmentSchema
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape harness.run
+ * @contractRole canonical
+ */
+export declare const HarnessRunSchema: z.ZodObject<{
     attempt: z.ZodInt;
     chassis: z.ZodEnum<{
         "claude-agent-sdk": "claude-agent-sdk";
@@ -57,17 +70,5 @@ declare const HarnessRunSchemaDefinition: z.ZodObject<{
     url: z.ZodString;
     userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
-type HarnessRunDefinition = z.infer<typeof HarnessRunSchemaDefinition>;
-/**
- * One harness enrichment run
- *
- * @openapiSchema HarnessRun
- * @endpoint POST /v1/entities/{entityId}/enrichments
- * @endpoint POST /v1/people/{personId}/enrichments
- * @contractShape harness.run
- * @contractRole canonical
- */
-export declare const HarnessRunSchema: z.ZodType<HarnessRunDefinition>;
 export type HarnessRun = z.infer<typeof HarnessRunSchema>;
-export {};
 //# sourceMappingURL=run.d.ts.map

package/dist/harness/run.js

@@ -7,7 +7,20 @@ import { HarnessRunEnvironmentSchema } from "./run-environment.js";
 import { HarnessRunLaneSchema } from "./run-lane.js";
 import { HarnessRunStatusSchema } from "./run-status.js";
 import { HarnessRunTypeSchema } from "./run-type.js";
-const HarnessRunSchemaDefinition = z.object({
+/**
+ * One harness enrichment run
+ *
+ * @openapiSchema HarnessRun
+ * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint POST /v1/enrichments
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema EnrichmentSchema
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape harness.run
+ * @contractRole canonical
+ */
+export const HarnessRunSchema = z.object({
     /** Retry attempt counter */
     attempt: z.int(),
     /** Agent loop this run executes on */
@@ -67,14 +80,4 @@ const HarnessRunSchemaDefinition = z.object({
     /** Optional steering prompt filed with the run */
     userPrompt: z.string().nullish(),
 });
-/**
- * One harness enrichment run
- *
- * @openapiSchema HarnessRun
- * @endpoint POST /v1/entities/{entityId}/enrichments
- * @endpoint POST /v1/people/{personId}/enrichments
- * @contractShape harness.run
- * @contractRole canonical
- */
-export const HarnessRunSchema = HarnessRunSchemaDefinition;
 //# sourceMappingURL=run.js.map

package/dist/http/problem-detail.d.ts

@@ -1,12 +1,10 @@
 import { z } from "zod/v4";
 declare const ProblemDetailSchemaDefinition: z.ZodObject<{
     allowanceType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        COMPANY: "COMPANY";
         ENTITY_VIEW: "ENTITY_VIEW";
-        NEW_COMPANY: "NEW_COMPANY";
-        NEW_PERSON: "NEW_PERSON";
+        PERSON: "PERSON";
         PERSON_VIEW: "PERSON_VIEW";
-        UPDATE: "UPDATE";
-        UPDATE_PERSON: "UPDATE_PERSON";
         WEB_SEARCH: "WEB_SEARCH";
     }>>>;
     circuitBreaker: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/http/problem-detail.js

@@ -8,15 +8,7 @@ import { RedirectSlugPathSchema } from "../redirect/redirect-slug-path.js";
 const ProblemDetailSchemaDefinition = z.object({
     /** Which monthly allowance a BILLING_ALLOWANCE refusal exhausted. */
     allowanceType: z
-        .enum([
-        "NEW_COMPANY",
-        "UPDATE",
-        "NEW_PERSON",
-        "UPDATE_PERSON",
-        "ENTITY_VIEW",
-        "PERSON_VIEW",
-        "WEB_SEARCH",
-    ])
+        .enum(["COMPANY", "PERSON", "ENTITY_VIEW", "PERSON_VIEW", "WEB_SEARCH"])
         .nullish(),
     circuitBreaker: z.string().nullish(),
     /** Machine-readable secondary code on ProblemDetail.code. Agents should branch on this value when the HTTP status alone does not identify the recovery path. Code groups include auth/session, rate limiting, job infrastructure, RBAC, external providers, image processing, R2 storage, search, and inference. Many codes indicate infra/admin-only conditions where the correct agent action is to surface the error and stop, not retry. */

package/dist/identification/candidate.d.ts

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * One existing record considered as the subject.
  *
  * @openapiSchema IdentificationCandidate
+ * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint POST /v1/entities/lookup
  * @endpoint POST /v1/lookup
  * @endpoint POST /v1/people/lookup
@@ -11,6 +12,7 @@ import { z } from "zod/v4";
  * @contractRole canonical
  */
 export declare const IdentificationCandidateSchema: z.ZodObject<{
+    dataCompletionCoverage: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     duplicateBasis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         JUDGED: "JUDGED";
         SHARED_FACT: "SHARED_FACT";
@@ -43,6 +45,7 @@ export declare const IdentificationCandidateSchema: 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>;
 export type IdentificationCandidate = z.infer<typeof IdentificationCandidateSchema>;
 //# sourceMappingURL=candidate.d.ts.map

package/dist/identification/candidate.js

@@ -6,6 +6,7 @@ import { SearchDuplicateCandidateScoreSchema } from "../search/duplicate-candida
  * One existing record considered as the subject.
  *
  * @openapiSchema IdentificationCandidate
+ * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint POST /v1/entities/lookup
  * @endpoint POST /v1/lookup
  * @endpoint POST /v1/people/lookup
@@ -14,6 +15,8 @@ import { SearchDuplicateCandidateScoreSchema } from "../search/duplicate-candida
  * @contractRole canonical
  */
 export const IdentificationCandidateSchema = z.object({
+    /** Percentage, 0 to 100, of the company's required completion-floor slots that pass, as last computed by the background coverage sweep; GET /v1/entities/{entityId}/coverage returns the live per-slot detail. Absent for people, who have no completion floor, and for companies not yet computed. */
+    dataCompletionCoverage: z.int().min(0).max(100).nullish(),
     /** How this record was checked as the picked record stored again; absent when it was not checked. */
     duplicateBasis: z.enum(["STUB", "SHARED_FACT", "JUDGED"]).nullish(),
     /** Decision-model probability, 0 to 1, that this record is the picked record stored again; present only when duplicateBasis is JUDGED. */
@@ -24,5 +27,7 @@ export const IdentificationCandidateSchema = z.object({
     probability: z.number().nullish(),
     /** The record with its duplicate-check score and reasons; score 0 with no reason means only vector similarity proposed it. */
     record: SearchDuplicateCandidateScoreSchema,
+    /** When the stored record was last updated. */
+    updatedAt: z.iso.datetime({ offset: true }).nullish(),
 });
 //# sourceMappingURL=candidate.js.map

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