@aventurevc/api-schemas 0.7.272

package/dist/entity/list.js

@@ -0,0 +1,41 @@
+// 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 { ContentEmbeddingMatchSchema } from "../content/embedding-match.js";
+import { EntityEnrichmentSchema } from "./enrichment.js";
+import { EntitySchema } from "./entity.js";
+import { EntityFundraiseTransactionSchema } from "./fundraise-transaction.js";
+import { EntityListResearchSchema } from "./list-research.js";
+const EntityListSchemaDefinition = z.object({
+    /** Flat entity core — identity, naming, status, image, and source metadata */
+    core: EntitySchema,
+    /** Supplemental entity data — addresses, classification tags, funding, text content, and URL links */
+    enrichment: EntityEnrichmentSchema,
+    /** Fundraise rounds associated with this entity */
+    fundraiseRound: z.array(EntityFundraiseTransactionSchema),
+    /** List-safe research disclosure without text snippets */
+    research: EntityListResearchSchema,
+    /** Semantic embedding match evidence populated only for semantic list reads. */
+    semanticMatch: ContentEmbeddingMatchSchema.nullish(),
+});
+/**
+ * Narrow entity row for list and batch-list reads. Keeps core identity, enrichment, governed research detail, accelerator participation, and fundraise rounds while omitting detail-only relationship, newsArticle, person, sitemap, and research snippet sections. Classification enrichment is current-only on list rows; use the entity classifications subresource with includeInactive=true to audit historical joins.
+ *
+ * @openapiSchema EntityList
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail/similar
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntitySimilarityResultSchema
+ * @usedBySchema EntitySuggestionSchema
+ * @usedBySchema PageEntityListSchema
+ * @usedBySchema PageResultEntityListSchema
+ * @contractShape entity.list
+ * @contractRole canonical
+ */
+export const EntityListSchema = EntityListSchemaDefinition;
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1,16 @@
+import { z } from "zod/v4";
+/**
+ * Distinguishes square icon vs standard/horizontal entity logo
+ *
+ * @openapiSchema EntityLogoType
+ * @endpoint GET /v1/media
+ * @endpoint GET /v1/entities/{entityId}/media/logo
+ * @contractShape entity.logo-type
+ * @contractRole canonical
+ */
+export declare const EntityLogoTypeSchema: z.ZodEnum<{
+    SQUARE: "SQUARE";
+    STANDARD: "STANDARD";
+}>;
+export type EntityLogoType = z.infer<typeof EntityLogoTypeSchema>;
+//# sourceMappingURL=logo-type.d.ts.map

package/dist/entity/logo-type.js

@@ -0,0 +1,13 @@
+// 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";
+/**
+ * Distinguishes square icon vs standard/horizontal entity logo
+ *
+ * @openapiSchema EntityLogoType
+ * @endpoint GET /v1/media
+ * @endpoint GET /v1/entities/{entityId}/media/logo
+ * @contractShape entity.logo-type
+ * @contractRole canonical
+ */
+export const EntityLogoTypeSchema = z.enum(["SQUARE", "STANDARD"]);
+//# sourceMappingURL=logo-type.js.map

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

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+export declare const ENTITY_LOOKUP_ENDPOINT: "/v1/entities/lookup";
+/**
+ * Request-side query params for `GET /v1/entities/lookup`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/entities/lookup
+ * @contractShape entity.lookup-param
+ * @contractRole canonical
+ */
+export declare const EntityLookupParamSchema: z.ZodObject<{
+    companySlug: z.ZodOptional<z.ZodString>;
+    includePrivate: z.ZodOptional<z.ZodBoolean>;
+    location: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    nameBrand: z.ZodOptional<z.ZodString>;
+    nameLegal: z.ZodOptional<z.ZodString>;
+    permitMonogram: z.ZodOptional<z.ZodBoolean>;
+    providerTypeRecord: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    typeRecord: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    urlDomain: z.ZodOptional<z.ZodString>;
+    urlMatchMode: z.ZodOptional<z.ZodString>;
+    urlType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EntityLookupParam = z.infer<typeof EntityLookupParamSchema>;
+//# sourceMappingURL=lookup-param.d.ts.map

package/dist/entity/lookup-param.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";
+export const ENTITY_LOOKUP_ENDPOINT = "/v1/entities/lookup";
+/**
+ * Request-side query params for `GET /v1/entities/lookup`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/entities/lookup
+ * @contractShape entity.lookup-param
+ * @contractRole canonical
+ */
+export const EntityLookupParamSchema = z.object({
+    /** Provider slug for Product/Service slug lookup. Historically named companySlug; providerTypeRecord can narrow this to Company, Nonprofit, or Government routes. */
+    companySlug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255)
+        .optional(),
+    /** Privileged admin readback scope. Includes hidden or off-sitemap entities and hidden research snippets. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public. */
+    includePrivate: z.boolean().optional(),
+    /** Location candidate: city, state, or country. */
+    location: z.string().optional(),
+    /** Primary entity name candidate. */
+    name: z.string().optional(),
+    /** Brand name candidate. */
+    nameBrand: z.string().optional(),
+    /** Legal name candidate. */
+    nameLegal: z.string().optional(),
+    /** Allow generated monogram logo fallback. */
+    permitMonogram: z.boolean().optional(),
+    /** Concrete provider type qualifier for a Product/Service provider route; group-only Organization is invalid. Use with companySlug when resolving `/companies/{slug}/products-services/{product}`, `/non-profits/{slug}/products-services/{product}`, or `/government/{slug}/products-services/{product}`. */
+    providerTypeRecord: z.string().optional(),
+    /** Exact entity slug. */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255)
+        .optional(),
+    /** Concrete entity type qualifier; group-only Organization is invalid. List the accepted concrete tokens and their aliases with GET /v1/entities/types (CLI: entities type-record types list). */
+    typeRecord: z.string().optional(),
+    /** Entity URL matched by host and path unless urlMatchMode=domain. */
+    url: z.string().optional(),
+    /** Website domain candidate without protocol or path. */
+    urlDomain: z.string().optional(),
+    /** URL matching mode: hostPath (default for url) or domain. Omit when urlDomain is supplied; urlDomain selects domain mode automatically. */
+    urlMatchMode: z.string().optional(),
+    /** URL type qualifier. List the accepted tokens with GET /v1/entities/urls/types (CLI: entities urls types list). */
+    urlType: z.string().optional(),
+});
+//# sourceMappingURL=lookup-param.js.map

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

@@ -0,0 +1,59 @@
+import { z } from "zod/v4";
+declare const EntityNameAliasEntityAliasTypeSchemaDefinition: z.ZodObject<{
+    displayable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    name: z.ZodString;
+    type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        alternativeDba: "alternativeDba";
+        relatedLegal: "relatedLegal";
+    }>>>;
+}, z.core.$strip>;
+type EntityNameAliasEntityAliasTypeDefinition = z.infer<typeof EntityNameAliasEntityAliasTypeSchemaDefinition>;
+/**
+ * Alternate name used for search and display
+ *
+ * @openapiSchema EntityNameAliasEntityAliasType
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/fundraise-rounds
+ * @endpoint GET /v1/entities/detail/investments
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/detail/person-investors
+ * @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}/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/detail/fundraise-rounds/{transactionId}
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{id}/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/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 EntitySchema
+ * @contractShape entity.name-alias-entity-alias-type
+ * @contractRole canonical
+ */
+export declare const EntityNameAliasEntityAliasTypeSchema: z.ZodType<EntityNameAliasEntityAliasTypeDefinition>;
+export type EntityNameAliasEntityAliasType = z.infer<typeof EntityNameAliasEntityAliasTypeSchema>;
+export {};
+//# sourceMappingURL=name-alias-entity-alias-type.d.ts.map

package/dist/entity/name-alias-entity-alias-type.js

@@ -0,0 +1,58 @@
+// 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 { EntityAliasTypeSchema } from "./alias-type.js";
+const EntityNameAliasEntityAliasTypeSchemaDefinition = z.object({
+    /** Show this alias in public name displays. */
+    displayable: z.boolean().nullish(),
+    /** Alternate name text */
+    name: z.string(),
+    /** Alias type classification */
+    type: EntityAliasTypeSchema.nullish(),
+});
+/**
+ * Alternate name used for search and display
+ *
+ * @openapiSchema EntityNameAliasEntityAliasType
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/fundraise-rounds
+ * @endpoint GET /v1/entities/detail/investments
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/detail/person-investors
+ * @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}/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/detail/fundraise-rounds/{transactionId}
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{id}/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/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 EntitySchema
+ * @contractShape entity.name-alias-entity-alias-type
+ * @contractRole canonical
+ */
+export const EntityNameAliasEntityAliasTypeSchema = EntityNameAliasEntityAliasTypeSchemaDefinition;
+//# sourceMappingURL=name-alias-entity-alias-type.js.map

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

@@ -0,0 +1,46 @@
+import { z } from "zod/v4";
+declare const EntityNameAliasPersonAliasTypeSchemaDefinition: z.ZodObject<{
+    displayable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    name: z.ZodString;
+    type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        formerName: "formerName";
+        maidenName: "maidenName";
+        nickname: "nickname";
+        stageName: "stageName";
+    }>>>;
+}, z.core.$strip>;
+type EntityNameAliasPersonAliasTypeDefinition = z.infer<typeof EntityNameAliasPersonAliasTypeSchemaDefinition>;
+/**
+ * Alternate name used for search and display
+ *
+ * @openapiSchema EntityNameAliasPersonAliasType
+ * @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/people
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/similar
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/people/{personId}
+ * @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 PersonDetailSchema
+ * @usedBySchema PersonSchema
+ * @contractShape entity.name-alias-person-alias-type
+ * @contractRole canonical
+ */
+export declare const EntityNameAliasPersonAliasTypeSchema: z.ZodType<EntityNameAliasPersonAliasTypeDefinition>;
+export type EntityNameAliasPersonAliasType = z.infer<typeof EntityNameAliasPersonAliasTypeSchema>;
+export {};
+//# sourceMappingURL=name-alias-person-alias-type.d.ts.map

package/dist/entity/name-alias-person-alias-type.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 { PersonAliasTypeSchema } from "../person/alias-type.js";
+const EntityNameAliasPersonAliasTypeSchemaDefinition = z.object({
+    /** Show this alias in public name displays. */
+    displayable: z.boolean().nullish(),
+    /** Alternate name text */
+    name: z.string(),
+    /** Alias type classification */
+    type: PersonAliasTypeSchema.nullish(),
+});
+/**
+ * Alternate name used for search and display
+ *
+ * @openapiSchema EntityNameAliasPersonAliasType
+ * @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/people
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/similar
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/people/{personId}
+ * @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 PersonDetailSchema
+ * @usedBySchema PersonSchema
+ * @contractShape entity.name-alias-person-alias-type
+ * @contractRole canonical
+ */
+export const EntityNameAliasPersonAliasTypeSchema = EntityNameAliasPersonAliasTypeSchemaDefinition;
+//# sourceMappingURL=name-alias-person-alias-type.js.map

package/dist/entity/natural-search.d.ts

@@ -0,0 +1,229 @@
+import { z } from "zod/v4";
+declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodObject<{
+        acceleratorBrand: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        acceleratorCohort: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        acceleratorName: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        acceleratorStatus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        affinity: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        employeeCountRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown>>>>;
+        entityId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+        entityName: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        featured: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        fundraiseActivity: z.ZodOptional<z.ZodObject<{
+            amountInvestedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            amountRaisedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            investedCompanyName: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            investorActivity: z.ZodOptional<z.ZodObject<{
+                averageAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                largestAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                smallestAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                totalAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                totalInvestmentRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+            }, z.core.$strip>>;
+            lastRoundYearRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            round: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            totalRaisedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            valuationRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+        }, z.core.$strip>>;
+        hasFundraising: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        headquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        headquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        headquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        industry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        letter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        location: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        logoOption: z.ZodOptional<z.ZodObject<{
+            sortPriority: z.ZodEnum<{
+                ANY_LOGO_FIRST: "ANY_LOGO_FIRST";
+                NONE: "NONE";
+                REAL_LOGO_FIRST: "REAL_LOGO_FIRST";
+            }>;
+        }, z.core.$strip>>;
+        mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        operatingStatus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        portfolioHeadquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        portfolioHeadquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        portfolioHeadquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        qualityGate: z.ZodOptional<z.ZodEnum<{
+            COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
+            NONE: "NONE";
+        }>>;
+        slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        suppressZeroTotalRaised: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        tag: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        textSearch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        typeCustomer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeModel: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeOwnership: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeRecord: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "Business Line": "Business Line";
+            Company: "Company";
+            Fund: "Fund";
+            Government: "Government";
+            "Investment Firm": "Investment Firm";
+            Nonprofit: "Nonprofit";
+            Organization: "Organization";
+            Product: "Product";
+            Service: "Service";
+        }>>>;
+        typeRevenue: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeTechnologyUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        urlDomain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        urlMatchMode: z.ZodOptional<z.ZodEnum<{
+            domain: "domain";
+            hostPath: "hostPath";
+        }>>;
+        urlType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            alternativeto: "alternativeto";
+            angellist: "angellist";
+            appstore: "appstore";
+            awsmarketplace: "awsmarketplace";
+            bloomberg: "bloomberg";
+            capterra: "capterra";
+            changelog: "changelog";
+            chromewebstore: "chromewebstore";
+            crates: "crates";
+            crunchbase: "crunchbase";
+            discord: "discord";
+            dockerhub: "dockerhub";
+            documentation: "documentation";
+            facebook: "facebook";
+            forum: "forum";
+            g2: "g2";
+            gartnerpeerinsights: "gartnerpeerinsights";
+            getapp: "getapp";
+            github: "github";
+            glassdoor: "glassdoor";
+            googleplay: "googleplay";
+            homebrew: "homebrew";
+            hubspotmarketplace: "hubspotmarketplace";
+            instagram: "instagram";
+            linkedin: "linkedin";
+            maven: "maven";
+            morningstar: "morningstar";
+            nasdaq: "nasdaq";
+            npm: "npm";
+            nyse: "nyse";
+            pitchbook: "pitchbook";
+            producthunt: "producthunt";
+            pypi: "pypi";
+            roadmap: "roadmap";
+            salesforceappexchange: "salesforceappexchange";
+            slackappdirectory: "slackappdirectory";
+            sourceforge: "sourceforge";
+            statuspage: "statuspage";
+            subreddit: "subreddit";
+            support: "support";
+            theorg: "theorg";
+            tiktok: "tiktok";
+            trustpilot: "trustpilot";
+            trustradius: "trustradius";
+            twitter: "twitter";
+            vscodemarketplace: "vscodemarketplace";
+            website: "website";
+            wellfound: "wellfound";
+            wikipedia: "wikipedia";
+            ycombinator: "ycombinator";
+            youtube: "youtube";
+        }>>>;
+        yearFoundedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown>>>>;
+    }, z.core.$strict>>;
+    search: z.ZodType<{
+        mode?: "auto" | "exact" | "keyword" | "natural" | "semantic" | undefined;
+        model?: string | null | undefined;
+        query: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        mode?: "auto" | "exact" | "keyword" | "natural" | "semantic" | undefined;
+        model?: string | null | undefined;
+        query: string;
+    }, unknown>>;
+}, z.core.$strip>;
+type EntityNaturalSearchDefinition = z.infer<typeof EntityNaturalSearchSchemaDefinition>;
+/**
+ * Plain-English entity search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.
+ *
+ * @openapiSchema EntityNaturalSearch
+ * @endpoint POST /v1/entities/natural-search
+ * @contractShape entity.natural-search
+ * @contractRole canonical
+ */
+export declare const EntityNaturalSearchSchema: z.ZodType<EntityNaturalSearchDefinition>;
+export type EntityNaturalSearch = z.infer<typeof EntityNaturalSearchSchema>;
+export {};
+//# sourceMappingURL=natural-search.d.ts.map

package/dist/entity/natural-search.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";
+import { EntityFilterSchema } from "./filter.js";
+import { NaturalSearchSchema } from "../natural/search.js";
+const EntityNaturalSearchSchemaDefinition = z.object({
+    /** Explicit entity constraints. Caller-supplied fields override planner values; the planner fills only fields left at their canonical defaults. */
+    filter: EntityFilterSchema.optional(),
+    /** Canonical plain-English search request and strategy. */
+    search: NaturalSearchSchema,
+});
+/**
+ * Plain-English entity search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.
+ *
+ * @openapiSchema EntityNaturalSearch
+ * @endpoint POST /v1/entities/natural-search
+ * @contractShape entity.natural-search
+ * @contractRole canonical
+ */
+export const EntityNaturalSearchSchema = EntityNaturalSearchSchemaDefinition;
+//# sourceMappingURL=natural-search.js.map