@aventurevc/api-schemas 0.7.283

package/dist/entity/acquisition.d.ts

@@ -0,0 +1,162 @@
+import { z } from "zod/v4";
+declare const EntityAcquisitionSchemaDefinition: z.ZodObject<{
+    acquiredEntity: z.ZodObject<{
+        createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        id: z.ZodUUID;
+        image: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
+        lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        nameAlias: z.ZodArray<z.ZodType<{
+            displayable?: boolean | null | undefined;
+            name: string;
+            type?: "alternativeDba" | "relatedLegal" | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            displayable?: boolean | null | undefined;
+            name: string;
+            type?: "alternativeDba" | "relatedLegal" | null | undefined;
+        }, unknown>>>;
+        nameBrand: z.ZodString;
+        nameLegal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        operatingStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        publicId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        publicUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sitemap: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            hasAcquisitions: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            hasAnalysis: z.ZodBoolean;
+            hasEmployees: z.ZodBoolean;
+            hasFundraising: z.ZodBoolean;
+            hasNews: z.ZodBoolean;
+            productServiceSlug: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>>;
+        slug: z.ZodString;
+        typeRecord: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            "Business Line": "Business Line";
+            Company: "Company";
+            Fund: "Fund";
+            Government: "Government";
+            "Investment Firm": "Investment Firm";
+            Nonprofit: "Nonprofit";
+            Organization: "Organization";
+            Product: "Product";
+            Service: "Service";
+        }>>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    }, z.core.$strip>;
+    acquirerEntity: z.ZodObject<{
+        createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        id: z.ZodUUID;
+        image: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
+        lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        nameAlias: z.ZodArray<z.ZodType<{
+            displayable?: boolean | null | undefined;
+            name: string;
+            type?: "alternativeDba" | "relatedLegal" | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            displayable?: boolean | null | undefined;
+            name: string;
+            type?: "alternativeDba" | "relatedLegal" | null | undefined;
+        }, unknown>>>;
+        nameBrand: z.ZodString;
+        nameLegal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        operatingStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        publicId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        publicUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sitemap: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            hasAcquisitions: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            hasAnalysis: z.ZodBoolean;
+            hasEmployees: z.ZodBoolean;
+            hasFundraising: z.ZodBoolean;
+            hasNews: z.ZodBoolean;
+            productServiceSlug: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>>;
+        slug: z.ZodString;
+        typeRecord: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            "Business Line": "Business Line";
+            Company: "Company";
+            Fund: "Fund";
+            Government: "Government";
+            "Investment Firm": "Investment Firm";
+            Nonprofit: "Nonprofit";
+            Organization: "Organization";
+            Product: "Product";
+            Service: "Service";
+        }>>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    }, z.core.$strip>;
+    amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    announcedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    asOf: z.ZodOptional<z.ZodNullable<z.ZodISODate>>;
+    completedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dataConfidence: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        High: "High";
+        Low: "Low";
+        Medium: "Medium";
+        Verified: "Verified";
+    }>>>;
+    evidence: z.ZodType<{
+        fundraiseInvestorJoin: boolean;
+        fundraiseTransaction: boolean;
+        operatingStatus: boolean;
+        relationship: boolean;
+    }, unknown, z.core.$ZodTypeInternals<{
+        fundraiseInvestorJoin: boolean;
+        fundraiseTransaction: boolean;
+        operatingStatus: boolean;
+        relationship: boolean;
+    }, unknown>>;
+    fundraiseTransactionId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    investorJoinId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    relationshipId: z.ZodInt;
+    source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodEnum<{
+        Acquired: "Acquired";
+        "Acquired Subsidiary": "Acquired Subsidiary";
+        Acquisition: "Acquisition";
+    }>;
+    transactionStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        Active: "Active";
+        Announced: "Announced";
+        "Announced; subject to approvals and closing conditions": "Announced; subject to approvals and closing conditions";
+        Closed: "Closed";
+        Completed: "Completed";
+        "In Progress": "In Progress";
+        Open: "Open";
+    }>>>;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+}, z.core.$strip>;
+type EntityAcquisitionDefinition = z.infer<typeof EntityAcquisitionSchemaDefinition>;
+/**
+ * Canonical acquisition event: scoped entity is acquired, acquirerEntity is buyer, and status is read stage -- Acquisition before operating-status change, Acquired Subsidiary for active completed brands, Acquired for terminal/folded/closed (including Closed (Acquihire)).
+ *
+ * @openapiSchema EntityAcquisition
+ * @endpoint GET /v1/entities/{entityId}/acquisitions
+ * @endpoint GET /v1/entities/{entityId}/acquisitions/{relationshipId}
+ * @usedBySchema PageEntityAcquisitionSchema
+ * @contractShape entity.acquisition
+ * @contractRole canonical
+ */
+export declare const EntityAcquisitionSchema: z.ZodType<EntityAcquisitionDefinition>;
+export type EntityAcquisition = z.infer<typeof EntityAcquisitionSchema>;
+export {};
+//# sourceMappingURL=acquisition.d.ts.map

package/dist/entity/acquisition.js

@@ -0,0 +1,43 @@
+// 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 { EntityAcquisitionEvidenceSchema } from "./acquisition-evidence.js";
+import { EntityAcquisitionStageSchema } from "./acquisition-stage.js";
+import { EntitySchema } from "./entity.js";
+import { FundraiseDataConfidenceSchema } from "../fundraise/data-confidence.js";
+import { FundraiseTransactionStatusSchema } from "../fundraise/transaction-status.js";
+const EntityAcquisitionSchemaDefinition = z.object({
+    /** Acquired company — read-only nested display projection of the scoped path entity. */
+    acquiredEntity: EntitySchema,
+    /** Buyer — read-only nested display projection. Mutations identify the buyer only via the flat acquirerEntityId UUID, never a nested entity object. */
+    acquirerEntity: EntitySchema,
+    amount: z.number().int().nullish(),
+    announcedAt: z.iso.datetime({ offset: true }).nullish(),
+    asOf: z.iso.date().nullish(),
+    completedAt: z.iso.datetime({ offset: true }).nullish(),
+    createdAt: z.iso.datetime({ offset: true }).nullish(),
+    currency: z.string().nullish(),
+    dataConfidence: FundraiseDataConfidenceSchema.nullish(),
+    evidence: EntityAcquisitionEvidenceSchema,
+    /** Canonical fundraise transaction UUID */
+    fundraiseTransactionId: z.uuid().nullish(),
+    /** Type-safe identifier for fundraise investor joins */
+    investorJoinId: z.uuid().nullish(),
+    relationshipId: z.int(),
+    source: z.string().nullish(),
+    /** Read stage, not transactionStatus: Acquisition before operating-status change; Acquired Subsidiary for active completed acquisitions; Acquired for terminal/folded/closed (including Closed (Acquihire)). */
+    status: EntityAcquisitionStageSchema,
+    transactionStatus: FundraiseTransactionStatusSchema.nullish(),
+    updatedAt: z.iso.datetime({ offset: true }).nullish(),
+});
+/**
+ * Canonical acquisition event: scoped entity is acquired, acquirerEntity is buyer, and status is read stage -- Acquisition before operating-status change, Acquired Subsidiary for active completed brands, Acquired for terminal/folded/closed (including Closed (Acquihire)).
+ *
+ * @openapiSchema EntityAcquisition
+ * @endpoint GET /v1/entities/{entityId}/acquisitions
+ * @endpoint GET /v1/entities/{entityId}/acquisitions/{relationshipId}
+ * @usedBySchema PageEntityAcquisitionSchema
+ * @contractShape entity.acquisition
+ * @contractRole canonical
+ */
+export const EntityAcquisitionSchema = EntityAcquisitionSchemaDefinition;
+//# sourceMappingURL=acquisition.js.map

package/dist/entity/alias-type.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod/v4";
+/**
+ * Alias types for entity NameAlias
+ *
+ * @openapiSchema EntityAliasType
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/similar
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/investments
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/sitemap/entities/routes
+ * @endpoint GET /v1/addresses/locations/{scope}/{slug}
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/acquisitions
+ * @endpoint GET /v1/entities/{entityId}/acquisitions/{relationshipId}
+ * @endpoint GET /v1/entities/{entityId}/fundraise-rounds
+ * @endpoint GET /v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}
+ * @endpoint GET /v1/entities/{entityId}/investments
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/person-investors
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @endpoint GET /v1/entities/{entityId}/research
+ * @endpoint GET /v1/entities/{entityId}/similar
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{newsId}/related-companies
+ * @endpoint GET /v1/people/{personId}
+ * @endpoint GET /v1/people/{personId}/graph
+ * @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/entities/lookup/matches
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/detail/batch
+ * @endpoint POST /v1/people/lookup/batch
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityNameAliasEntityAliasTypeSchema
+ * @contractShape entity.alias-type
+ * @contractRole canonical
+ */
+export declare const EntityAliasTypeSchema: z.ZodEnum<{
+    alternativeDba: "alternativeDba";
+    relatedLegal: "relatedLegal";
+}>;
+export type EntityAliasType = z.infer<typeof EntityAliasTypeSchema>;
+//# sourceMappingURL=alias-type.d.ts.map

package/dist/entity/alias-type.js

@@ -0,0 +1,51 @@
+// 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";
+/**
+ * Alias types for entity NameAlias
+ *
+ * @openapiSchema EntityAliasType
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/similar
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/investments
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/sitemap/entities/routes
+ * @endpoint GET /v1/addresses/locations/{scope}/{slug}
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/acquisitions
+ * @endpoint GET /v1/entities/{entityId}/acquisitions/{relationshipId}
+ * @endpoint GET /v1/entities/{entityId}/fundraise-rounds
+ * @endpoint GET /v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}
+ * @endpoint GET /v1/entities/{entityId}/investments
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/person-investors
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @endpoint GET /v1/entities/{entityId}/research
+ * @endpoint GET /v1/entities/{entityId}/similar
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{newsId}/related-companies
+ * @endpoint GET /v1/people/{personId}
+ * @endpoint GET /v1/people/{personId}/graph
+ * @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/entities/lookup/matches
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/detail/batch
+ * @endpoint POST /v1/people/lookup/batch
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityNameAliasEntityAliasTypeSchema
+ * @contractShape entity.alias-type
+ * @contractRole canonical
+ */
+export const EntityAliasTypeSchema = z.enum(["alternativeDba", "relatedLegal"]);
+//# sourceMappingURL=alias-type.js.map

package/dist/entity/batch-param.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+export declare const ENTITY_BATCH_ENDPOINT: "/v1/entities/batch";
+/**
+ * Request-side query params for `POST /v1/entities/batch`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/entities/batch
+ * @contractShape entity.batch-param
+ * @contractRole canonical
+ */
+export declare const EntityBatchParamSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodInt>;
+    size: z.ZodOptional<z.ZodInt>;
+    sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    includeFullDetail: z.ZodOptional<z.ZodBoolean>;
+    includePrivate: z.ZodOptional<z.ZodBoolean>;
+    permitMonogram: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type EntityBatchParam = z.infer<typeof EntityBatchParamSchema>;
+//# sourceMappingURL=batch-param.d.ts.map

package/dist/entity/batch-param.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 { PageParamSchema } from "../pagination/page-param.js";
+export const ENTITY_BATCH_ENDPOINT = "/v1/entities/batch";
+/**
+ * Request-side query params for `POST /v1/entities/batch`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/entities/batch
+ * @contractShape entity.batch-param
+ * @contractRole canonical
+ */
+export const EntityBatchParamSchema = PageParamSchema.extend({
+    /** Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort. */
+    cursor: z.string().optional(),
+    /** Privileged read flag. Send the exact lowercase literal "true" to return the /v1/entities/detail payload, or "false" (or omit it) for the list payload. Any other spelling is rejected. */
+    includeFullDetail: z.boolean().optional(),
+    /** Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published records are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public. */
+    includePrivate: z.boolean().optional(),
+    /** Permit monogram fallback */
+    permitMonogram: z.boolean().optional(),
+});
+//# sourceMappingURL=batch-param.js.map

package/dist/entity/classification-inactive-tag-override.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod/v4";
+/**
+ * Caller-chosen handling when the canonical classification value exists but is dormant.
+ *
+ * @openapiSchema EntityClassificationInactiveTagOverride
+ * @standardProblemResponse
+ * @usedBySchema ClassificationInactiveTagDetailsSchema
+ * @contractShape entity.classification-inactive-tag-override
+ * @contractRole canonical
+ */
+export declare const EntityClassificationInactiveTagOverrideSchema: z.ZodEnum<{
+    ATTACH_INACTIVE: "ATTACH_INACTIVE";
+    REACTIVATE: "REACTIVATE";
+}>;
+export type EntityClassificationInactiveTagOverride = z.infer<typeof EntityClassificationInactiveTagOverrideSchema>;
+//# sourceMappingURL=classification-inactive-tag-override.d.ts.map

package/dist/entity/classification-inactive-tag-override.js

@@ -0,0 +1,16 @@
+// 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";
+/**
+ * Caller-chosen handling when the canonical classification value exists but is dormant.
+ *
+ * @openapiSchema EntityClassificationInactiveTagOverride
+ * @standardProblemResponse
+ * @usedBySchema ClassificationInactiveTagDetailsSchema
+ * @contractShape entity.classification-inactive-tag-override
+ * @contractRole canonical
+ */
+export const EntityClassificationInactiveTagOverrideSchema = z.enum([
+    "REACTIVATE",
+    "ATTACH_INACTIVE",
+]);
+//# sourceMappingURL=classification-inactive-tag-override.js.map

package/dist/entity/classification-suggestion.d.ts

@@ -0,0 +1,98 @@
+import { z } from "zod/v4";
+declare const EntityClassificationSuggestionSchemaDefinition: z.ZodObject<{
+    alreadyJoined: z.ZodBoolean;
+    classification: z.ZodUnion<readonly [z.ZodType<{
+        creatable: boolean;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        name: string;
+        writable: boolean;
+    } & {
+        bucket?: string | null | undefined;
+        classificationId?: number | null | undefined;
+        creatable: boolean;
+        createdAt?: string | null | undefined;
+        id: number;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        name: string;
+        slug?: string | null | undefined;
+        type: string;
+        updatedAt?: string | null | undefined;
+        writable: boolean;
+    }, unknown, z.core.$ZodTypeInternals<{
+        creatable: boolean;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        name: string;
+        writable: boolean;
+    } & {
+        bucket?: string | null | undefined;
+        classificationId?: number | null | undefined;
+        creatable: boolean;
+        createdAt?: string | null | undefined;
+        id: number;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        name: string;
+        slug?: string | null | undefined;
+        type: string;
+        updatedAt?: string | null | undefined;
+        writable: boolean;
+    }, unknown>>, z.ZodType<{
+        creatable: boolean;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        name: string;
+        writable: boolean;
+    } & {
+        category: string;
+        code?: number | null | undefined;
+        creatable: boolean;
+        createdAt?: string | null | undefined;
+        entityClassificationId?: number | null | undefined;
+        id: number;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        level?: number | null | undefined;
+        name: string;
+        updatedAt?: string | null | undefined;
+        writable: boolean;
+    }, unknown, z.core.$ZodTypeInternals<{
+        creatable: boolean;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        name: string;
+        writable: boolean;
+    } & {
+        category: string;
+        code?: number | null | undefined;
+        creatable: boolean;
+        createdAt?: string | null | undefined;
+        entityClassificationId?: number | null | undefined;
+        id: number;
+        isCurrent?: boolean | null | undefined;
+        isPrimary?: boolean | null | undefined;
+        level?: number | null | undefined;
+        name: string;
+        updatedAt?: string | null | undefined;
+        writable: boolean;
+    }, unknown>>]>;
+    creatable: z.ZodBoolean;
+    rank: z.ZodInt;
+    score: z.ZodNumber;
+    writable: z.ZodBoolean;
+}, z.core.$strip>;
+type EntityClassificationSuggestionDefinition = z.infer<typeof EntityClassificationSuggestionSchemaDefinition>;
+/**
+ * Ranked classification suggestion derived from the enriched entity profile and classification centroid embeddings. Returned by the default classification discovery endpoint before callers create source-backed classification joins.
+ *
+ * @openapiSchema EntityClassificationSuggestion
+ * @endpoint GET /v1/entities/{entityId}/classifications/suggestions
+ * @contractShape entity.classification-suggestion
+ * @contractRole canonical
+ */
+export declare const EntityClassificationSuggestionSchema: z.ZodType<EntityClassificationSuggestionDefinition>;
+export type EntityClassificationSuggestion = z.infer<typeof EntityClassificationSuggestionSchema>;
+export {};
+//# sourceMappingURL=classification-suggestion.d.ts.map

package/dist/entity/classification-suggestion.js

@@ -0,0 +1,28 @@
+// 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 { EntityTagSchema } from "./tag.js";
+import { StandardizedClassificationSchema } from "../standardized/classification.js";
+const EntityClassificationSuggestionSchemaDefinition = z.object({
+    /** True when the entity already has a current or historical matching join. */
+    alreadyJoined: z.boolean(),
+    /** Suggested writable editorial tag or standardized classification code candidate. */
+    classification: z.union([EntityTagSchema, StandardizedClassificationSchema]),
+    /** Whether a missing editorial tag value may be created with type plus name instead of tagId. */
+    creatable: z.boolean(),
+    /** One-based rank within this suggestion response. */
+    rank: z.int(),
+    /** Composite embedding similarity score; larger values rank higher. */
+    score: z.number(),
+    /** Whether this suggestion can be joined through the classification mutation endpoint. */
+    writable: z.boolean(),
+});
+/**
+ * Ranked classification suggestion derived from the enriched entity profile and classification centroid embeddings. Returned by the default classification discovery endpoint before callers create source-backed classification joins.
+ *
+ * @openapiSchema EntityClassificationSuggestion
+ * @endpoint GET /v1/entities/{entityId}/classifications/suggestions
+ * @contractShape entity.classification-suggestion
+ * @contractRole canonical
+ */
+export const EntityClassificationSuggestionSchema = EntityClassificationSuggestionSchemaDefinition;
+//# sourceMappingURL=classification-suggestion.js.map