@aventurevc/api-schemas 0.7.272

package/dist/datasource/provenance-field-change.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v4";
+declare const DatasourceProvenanceFieldChangeSchemaDefinition: z.ZodObject<{
+    fieldName: z.ZodString;
+    newPresent: z.ZodBoolean;
+    newValue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    oldPresent: z.ZodBoolean;
+    oldValue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type DatasourceProvenanceFieldChangeDefinition = z.infer<typeof DatasourceProvenanceFieldChangeSchemaDefinition>;
+/**
+ * One changed field inside a provenance write event
+ *
+ * @openapiSchema DatasourceProvenanceFieldChange
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-field-change
+ * @contractRole canonical
+ */
+export declare const DatasourceProvenanceFieldChangeSchema: z.ZodType<DatasourceProvenanceFieldChangeDefinition>;
+export type DatasourceProvenanceFieldChange = z.infer<typeof DatasourceProvenanceFieldChangeSchema>;
+export {};
+//# sourceMappingURL=provenance-field-change.d.ts.map

package/dist/datasource/provenance-field-change.js

@@ -0,0 +1,21 @@
+// 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 DatasourceProvenanceFieldChangeSchemaDefinition = z.object({
+    fieldName: z.string(),
+    newPresent: z.boolean(),
+    newValue: z.string().nullish(),
+    oldPresent: z.boolean(),
+    oldValue: z.string().nullish(),
+});
+/**
+ * One changed field inside a provenance write event
+ *
+ * @openapiSchema DatasourceProvenanceFieldChange
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-field-change
+ * @contractRole canonical
+ */
+export const DatasourceProvenanceFieldChangeSchema = DatasourceProvenanceFieldChangeSchemaDefinition;
+//# sourceMappingURL=provenance-field-change.js.map

package/dist/datasource/provenance-operation.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+/**
+ * Write operation captured by a provenance event row
+ *
+ * @openapiSchema DatasourceProvenanceOperation
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-operation
+ * @contractRole canonical
+ */
+export declare const DatasourceProvenanceOperationSchema: z.ZodEnum<{
+    delete: "delete";
+    insert: "insert";
+    update: "update";
+}>;
+export type DatasourceProvenanceOperation = z.infer<typeof DatasourceProvenanceOperationSchema>;
+//# sourceMappingURL=provenance-operation.d.ts.map

package/dist/datasource/provenance-operation.js

@@ -0,0 +1,14 @@
+// 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";
+/**
+ * Write operation captured by a provenance event row
+ *
+ * @openapiSchema DatasourceProvenanceOperation
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-operation
+ * @contractRole canonical
+ */
+export const DatasourceProvenanceOperationSchema = z.enum(["insert", "update", "delete"]);
+//# sourceMappingURL=provenance-operation.js.map

package/dist/datasource/provenance-source.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod/v4";
+/**
+ * Write provenance supplied on mutation query parameters.
+ *
+ * @openapiSchema DatasourceProvenanceSource
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-source
+ * @contractRole canonical
+ */
+export declare const DatasourceProvenanceSourceSchema: z.ZodObject<{
+    actorType: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        employee: "employee";
+    }>>;
+    agentChassis: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sourceDetail: z.ZodString;
+    sourceProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sourceProviderId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sourceProviderSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sourceType: z.ZodEnum<{
+        api: "api";
+        aventureStaff: "aventureStaff";
+        blogArticle: "blogArticle";
+        firstPartyWebsite: "firstPartyWebsite";
+        import: "import";
+        llm: "llm";
+        manual: "manual";
+        newsArticle: "newsArticle";
+        relatedPartyWebsite: "relatedPartyWebsite";
+        requestChangeForm: "requestChangeForm";
+        thirdPartyWebsite: "thirdPartyWebsite";
+    }>;
+}, z.core.$strip>;
+export type DatasourceProvenanceSource = z.infer<typeof DatasourceProvenanceSourceSchema>;
+//# sourceMappingURL=provenance-source.d.ts.map

package/dist/datasource/provenance-source.js

@@ -0,0 +1,33 @@
+// 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 { DatasourceDataSourceTypeSchema } from "./data-source-type.js";
+import { DatasourceProvenanceActorTypeSchema } from "./provenance-actor-type.js";
+/**
+ * Write provenance supplied on mutation query parameters.
+ *
+ * @openapiSchema DatasourceProvenanceSource
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-source
+ * @contractRole canonical
+ */
+export const DatasourceProvenanceSourceSchema = z.object({
+    /** Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session. */
+    actorType: DatasourceProvenanceActorTypeSchema.optional(),
+    /** Agent chassis token for agent-authored writes. */
+    agentChassis: z.string().nullish(),
+    /** Agent model id for agent-authored writes. */
+    agentModel: z.string().nullish(),
+    /** Source detail or reviewer reference for the write. */
+    sourceDetail: z.string(),
+    /** Provider name for provider-native IDs or slugs. */
+    sourceProvider: z.string().nullish(),
+    /** Provider-native source ID. */
+    sourceProviderId: z.string().nullish(),
+    /** Provider-native source slug. */
+    sourceProviderSlug: z.string().nullish(),
+    /** Write provenance source type. */
+    sourceType: DatasourceDataSourceTypeSchema,
+});
+//# sourceMappingURL=provenance-source.js.map

package/dist/datasource/provenance-status.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+/**
+ * Confidence and dispute state of a field-level provenance row
+ *
+ * @openapiSchema DatasourceProvenanceStatus
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-status
+ * @contractRole canonical
+ */
+export declare const DatasourceProvenanceStatusSchema: z.ZodEnum<{
+    confirmed: "confirmed";
+    disputedAnonymous: "disputedAnonymous";
+    disputedFirstParty: "disputedFirstParty";
+    disputedRelatedParty: "disputedRelatedParty";
+    disputedThirdParty: "disputedThirdParty";
+    unconfirmed: "unconfirmed";
+}>;
+export type DatasourceProvenanceStatus = z.infer<typeof DatasourceProvenanceStatusSchema>;
+//# sourceMappingURL=provenance-status.d.ts.map

package/dist/datasource/provenance-status.js

@@ -0,0 +1,21 @@
+// 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";
+/**
+ * Confidence and dispute state of a field-level provenance row
+ *
+ * @openapiSchema DatasourceProvenanceStatus
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.provenance-status
+ * @contractRole canonical
+ */
+export const DatasourceProvenanceStatusSchema = z.enum([
+    "unconfirmed",
+    "confirmed",
+    "disputedFirstParty",
+    "disputedRelatedParty",
+    "disputedThirdParty",
+    "disputedAnonymous",
+]);
+//# sourceMappingURL=provenance-status.js.map

package/dist/datasource/source-metadata.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod/v4";
+/**
+ * Grouped source/provenance metadata for private v1 response fields
+ *
+ * @openapiSchema DatasourceSourceMetadata
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/detail/person-investors
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/media
+ * @endpoint GET /v1/people
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/similar
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/provenance/latest
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/media/logo
+ * @endpoint GET /v1/news/{newsId}/media/thumbnail
+ * @endpoint GET /v1/people/{personId}
+ * @endpoint GET /v1/people/{personId}/media/photo
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/detail/batch
+ * @endpoint POST /v1/people/lookup/batch
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema MediaUploadSchema
+ * @usedBySchema PersonSchema
+ * @contractShape datasource.source-metadata
+ * @contractRole canonical
+ */
+export declare const DatasourceSourceMetadataSchema: z.ZodObject<{
+    changedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    dataSourceUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    pendingApproval: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    sourceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type DatasourceSourceMetadata = z.infer<typeof DatasourceSourceMetadataSchema>;
+//# sourceMappingURL=source-metadata.d.ts.map

package/dist/datasource/source-metadata.js

@@ -0,0 +1,47 @@
+// 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";
+/**
+ * Grouped source/provenance metadata for private v1 response fields
+ *
+ * @openapiSchema DatasourceSourceMetadata
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/detail/person-investors
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/media
+ * @endpoint GET /v1/people
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/similar
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/provenance/latest
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/media/logo
+ * @endpoint GET /v1/news/{newsId}/media/thumbnail
+ * @endpoint GET /v1/people/{personId}
+ * @endpoint GET /v1/people/{personId}/media/photo
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/detail/batch
+ * @endpoint POST /v1/people/lookup/batch
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema MediaUploadSchema
+ * @usedBySchema PersonSchema
+ * @contractShape datasource.source-metadata
+ * @contractRole canonical
+ */
+export const DatasourceSourceMetadataSchema = z.object({
+    changedAt: z.iso.datetime({ offset: true }).nullish(),
+    dataSourceUpdatedAt: z.iso.datetime({ offset: true }).nullish(),
+    detail: z.string().nullish(),
+    kind: z.string().nullish(),
+    pendingApproval: z.int().nullish(),
+    sourceId: z.string().nullish(),
+    status: z.string().nullish(),
+});
+//# sourceMappingURL=source-metadata.js.map

package/dist/datasource/tracked-provenance-table.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod/v4";
+/**
+ * Domain resource whose field-level provenance is tracked
+ *
+ * @openapiSchema DatasourceTrackedProvenanceTable
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/latest
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.tracked-provenance-table
+ * @contractRole canonical
+ */
+export declare const DatasourceTrackedProvenanceTableSchema: z.ZodEnum<{
+    deployTarget: "deployTarget";
+    entity: "entity";
+    entityAddressJoin: "entityAddressJoin";
+    entityClassificationJoin: "entityClassificationJoin";
+    entityDetail: "entityDetail";
+    entityPersonJoin: "entityPersonJoin";
+    entityRelationship: "entityRelationship";
+    entityResearchSnippets: "entityResearchSnippets";
+    entityTypeJoin: "entityTypeJoin";
+    fundraiseTransaction: "fundraiseTransaction";
+    fundraiseTransactionInvestorJoin: "fundraiseTransactionInvestorJoin";
+    newsArticle: "newsArticle";
+    newsArticleEntityJoin: "newsArticleEntityJoin";
+    newsArticlePersonJoin: "newsArticlePersonJoin";
+    person: "person";
+    personAddressJoin: "personAddressJoin";
+    text: "text";
+    urlLink: "urlLink";
+}>;
+export type DatasourceTrackedProvenanceTable = z.infer<typeof DatasourceTrackedProvenanceTableSchema>;
+//# sourceMappingURL=tracked-provenance-table.d.ts.map

package/dist/datasource/tracked-provenance-table.js

@@ -0,0 +1,34 @@
+// 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";
+/**
+ * Domain resource whose field-level provenance is tracked
+ *
+ * @openapiSchema DatasourceTrackedProvenanceTable
+ * @endpoint GET /v1/provenance/history
+ * @endpoint GET /v1/provenance/latest
+ * @endpoint GET /v1/provenance/{provenanceId}
+ * @usedBySchema DatasourceFieldProvenanceSchema
+ * @contractShape datasource.tracked-provenance-table
+ * @contractRole canonical
+ */
+export const DatasourceTrackedProvenanceTableSchema = z.enum([
+    "entity",
+    "person",
+    "newsArticle",
+    "entityPersonJoin",
+    "newsArticleEntityJoin",
+    "newsArticlePersonJoin",
+    "entityRelationship",
+    "entityTypeJoin",
+    "entityAddressJoin",
+    "entityClassificationJoin",
+    "entityDetail",
+    "entityResearchSnippets",
+    "personAddressJoin",
+    "fundraiseTransaction",
+    "fundraiseTransactionInvestorJoin",
+    "text",
+    "urlLink",
+    "deployTarget",
+]);
+//# sourceMappingURL=tracked-provenance-table.js.map

package/dist/decimal/range.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod/v4";
+declare const DecimalRangeSchemaDefinition: z.ZodObject<{
+    max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    min: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+type DecimalRangeDefinition = z.infer<typeof DecimalRangeSchemaDefinition>;
+/**
+ * Decimal range for monetary and numeric filter criteria
+ *
+ * @openapiSchema DecimalRange
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/people
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/filters/refine
+ * @endpoint POST /v1/entities/filters/search
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityFundraiseFilterCriteriaSchema
+ * @usedBySchema InvestorActivityFilterSchema
+ * @usedBySchema PersonListArrayFilterSchema
+ * @contractShape decimal.range
+ * @contractRole canonical
+ */
+export declare const DecimalRangeSchema: z.ZodType<DecimalRangeDefinition>;
+export type DecimalRange = z.infer<typeof DecimalRangeSchema>;
+export {};
+//# sourceMappingURL=range.d.ts.map

package/dist/decimal/range.js

@@ -0,0 +1,33 @@
+// 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 DecimalRangeSchemaDefinition = z.object({
+    /** Inclusive maximum decimal number, such as 220000 or 123456.78. */
+    max: z.number().nullish(),
+    /** Inclusive minimum decimal number, such as 220000 or 123456.78. */
+    min: z.number().nullish(),
+});
+/**
+ * Decimal range for monetary and numeric filter criteria
+ *
+ * @openapiSchema DecimalRange
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/people
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/filters/refine
+ * @endpoint POST /v1/entities/filters/search
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityFundraiseFilterCriteriaSchema
+ * @usedBySchema InvestorActivityFilterSchema
+ * @usedBySchema PersonListArrayFilterSchema
+ * @contractShape decimal.range
+ * @contractRole canonical
+ */
+export const DecimalRangeSchema = DecimalRangeSchemaDefinition;
+//# sourceMappingURL=range.js.map

package/dist/domain/conflict-details.d.ts

@@ -0,0 +1,119 @@
+import { z } from "zod/v4";
+/**
+ * Polymorphic envelope for RFC 9457 ProblemDetail.details on HTTP 409 responses. The concrete variant depends on the conflict kind: URL ownership collisions return UrlDuplicateConflict; ambiguous strict URL lookups return StrictUrlLookupConflict; create-time duplicate review gates return DuplicateCreateReview; classification writes that touch an inactive tag bucket return ClassificationInactiveTagDetails; news publication+URL uniqueness violations return NewsSourceUrlConflict. Inspect ProblemDetail.code/type and the field set present on details to identify the variant.
+ *
+ * @openapiSchema DomainConflictDetails
+ * @standardProblemResponse
+ * @usedBySchema ProblemDetailSchema
+ * @contractShape domain.conflict-details
+ * @contractRole canonical
+ */
+export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType<{
+    existingJoin: {
+        owner: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        urlId: number;
+    }[];
+    fragmentIgnored: boolean;
+    guidance: string;
+    normalizedUrl?: string | null | undefined;
+    requestedOwner: {
+        entityId?: string | null | undefined;
+        personId?: string | null | undefined;
+    };
+    url: string;
+    urlType: string;
+}, unknown, z.core.$ZodTypeInternals<{
+    existingJoin: {
+        owner: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        urlId: number;
+    }[];
+    fragmentIgnored: boolean;
+    guidance: string;
+    normalizedUrl?: string | null | undefined;
+    requestedOwner: {
+        entityId?: string | null | undefined;
+        personId?: string | null | undefined;
+    };
+    url: string;
+    urlType: string;
+}, unknown>>, z.ZodType<{
+    candidateEntityId: string[];
+    candidatePersonId: string[];
+    hint: string;
+    normalizedUrl?: string | null | undefined;
+    url: string;
+    urlType?: string | null | undefined;
+}, unknown, z.core.$ZodTypeInternals<{
+    candidateEntityId: string[];
+    candidatePersonId: string[];
+    hint: string;
+    normalizedUrl?: string | null | undefined;
+    url: string;
+    urlType?: string | null | undefined;
+}, unknown>>, z.ZodType<{
+    candidate?: {
+        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;
+    }[] | null | undefined;
+    newsCandidate?: {
+        externalId?: string | null | undefined;
+        id: number;
+        reason: string[];
+        score: number;
+        slug?: string | null | undefined;
+    }[] | null | undefined;
+    overridePath?: string | null | undefined;
+    threshold: number;
+}, unknown, z.core.$ZodTypeInternals<{
+    candidate?: {
+        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;
+    }[] | null | undefined;
+    newsCandidate?: {
+        externalId?: string | null | undefined;
+        id: number;
+        reason: string[];
+        score: number;
+        slug?: string | null | undefined;
+    }[] | null | undefined;
+    overridePath?: string | null | undefined;
+    threshold: number;
+}, unknown>>, z.ZodType<{
+    availableOverrides: ("ATTACH_INACTIVE" | "REACTIVATE")[];
+    slug: string;
+    tagId: number;
+}, unknown, z.core.$ZodTypeInternals<{
+    availableOverrides: ("ATTACH_INACTIVE" | "REACTIVATE")[];
+    slug: string;
+    tagId: number;
+}, unknown>>, z.ZodType<{
+    conflictingArticleId: number;
+    conflictingArticleSlug: string;
+    conflictingArticleTitle: string;
+}, unknown, z.core.$ZodTypeInternals<{
+    conflictingArticleId: number;
+    conflictingArticleSlug: string;
+    conflictingArticleTitle: string;
+}, unknown>>]>;
+export type DomainConflictDetails = z.infer<typeof DomainConflictDetailsSchema>;
+//# sourceMappingURL=conflict-details.d.ts.map

package/dist/domain/conflict-details.js

@@ -0,0 +1,24 @@
+// 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 { ClassificationInactiveTagDetailsSchema } from "../classification/inactive-tag-details.js";
+import { DuplicateCreateReviewSchema } from "../duplicate/create-review.js";
+import { NewsSourceUrlConflictSchema } from "../news/source-url-conflict.js";
+import { StrictUrlLookupConflictSchema } from "../strict/url-lookup-conflict.js";
+import { UrlDuplicateConflictSchema } from "../url/duplicate-conflict.js";
+/**
+ * Polymorphic envelope for RFC 9457 ProblemDetail.details on HTTP 409 responses. The concrete variant depends on the conflict kind: URL ownership collisions return UrlDuplicateConflict; ambiguous strict URL lookups return StrictUrlLookupConflict; create-time duplicate review gates return DuplicateCreateReview; classification writes that touch an inactive tag bucket return ClassificationInactiveTagDetails; news publication+URL uniqueness violations return NewsSourceUrlConflict. Inspect ProblemDetail.code/type and the field set present on details to identify the variant.
+ *
+ * @openapiSchema DomainConflictDetails
+ * @standardProblemResponse
+ * @usedBySchema ProblemDetailSchema
+ * @contractShape domain.conflict-details
+ * @contractRole canonical
+ */
+export const DomainConflictDetailsSchema = z.union([
+    UrlDuplicateConflictSchema,
+    StrictUrlLookupConflictSchema,
+    DuplicateCreateReviewSchema,
+    ClassificationInactiveTagDetailsSchema,
+    NewsSourceUrlConflictSchema,
+]);
+//# sourceMappingURL=conflict-details.js.map

package/dist/duplicate/create-review.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod/v4";
+declare const DuplicateCreateReviewSchemaDefinition: z.ZodObject<{
+    candidate: z.ZodOptional<z.ZodNullable<z.ZodArray<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>>>>>;
+    newsCandidate: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        id: z.ZodInt;
+        reason: z.ZodArray<z.ZodString>;
+        score: z.ZodInt;
+        slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>;
+    overridePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    threshold: z.ZodInt;
+}, z.core.$strip>;
+type DuplicateCreateReviewDefinition = z.infer<typeof DuplicateCreateReviewSchemaDefinition>;
+/**
+ * Candidate-review conflict details returned in ProblemDetail.details for create gates and deterministic lookup ambiguity. The returned candidates are the decision surface: update the matching candidate, create with duplicate override only when every candidate is distinct from the source-backed target, or block when identity is unresolved. score and threshold rank review priority; they are not proof that the requested record is absent.
+ *
+ * @openapiSchema DuplicateCreateReview
+ * @standardProblemResponse
+ * @usedBySchema DomainConflictDetailsSchema
+ * @contractShape duplicate.create-review
+ * @contractRole canonical
+ */
+export declare const DuplicateCreateReviewSchema: z.ZodType<DuplicateCreateReviewDefinition>;
+export type DuplicateCreateReview = z.infer<typeof DuplicateCreateReviewSchema>;
+export {};
+//# sourceMappingURL=create-review.d.ts.map

package/dist/duplicate/create-review.js

@@ -0,0 +1,25 @@
+// 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 { NewsCandidateScoreSchema } from "../news/candidate-score.js";
+import { SearchDuplicateCandidateScoreSchema } from "../search/duplicate-candidate-score.js";
+const DuplicateCreateReviewSchemaDefinition = z.object({
+    /** Entity/person candidates returned by lookup or create duplicate review. If a candidate is the requested record, read/update that candidate by id. Create with duplicate override only after every candidate is reviewed as distinct. */
+    candidate: z.array(SearchDuplicateCandidateScoreSchema).nullish(),
+    /** News candidates returned by lookup or create duplicate review. If a candidate is the requested article, read/update that article by id. Otherwise block until source evidence proves a distinct article. */
+    newsCandidate: z.array(NewsCandidateScoreSchema).nullish(),
+    /** Create endpoint to retry only after reviewing the returned candidates and supplying overrideGate=duplicate and overrideReason as query parameters. Null for detail lookup ambiguity, where the next action is review/update/block. */
+    overridePath: z.string().nullish(),
+    /** Review threshold used by duplicate scoring. Scores below this value can still be useful candidate context; this value does not prove absence or authorize create. */
+    threshold: z.int(),
+});
+/**
+ * Candidate-review conflict details returned in ProblemDetail.details for create gates and deterministic lookup ambiguity. The returned candidates are the decision surface: update the matching candidate, create with duplicate override only when every candidate is distinct from the source-backed target, or block when identity is unresolved. score and threshold rank review priority; they are not proof that the requested record is absent.
+ *
+ * @openapiSchema DuplicateCreateReview
+ * @standardProblemResponse
+ * @usedBySchema DomainConflictDetailsSchema
+ * @contractShape duplicate.create-review
+ * @contractRole canonical
+ */
+export const DuplicateCreateReviewSchema = DuplicateCreateReviewSchemaDefinition;
+//# sourceMappingURL=create-review.js.map