@aventurevc/api-schemas 0.7.272

package/dist/person/investor-participation.js

@@ -0,0 +1,22 @@
+// 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 { FundraiseInvestmentAttributionSchema } from "../fundraise/investment-attribution.js";
+import { PersonDetailSchema } from "./detail.js";
+import { RoundLabelSchema } from "../round/label.js";
+const PersonInvestorParticipationSchemaDefinition = z.object({
+    investorAttribution: z.array(FundraiseInvestmentAttributionSchema),
+    person: PersonDetailSchema,
+    round: z.array(RoundLabelSchema),
+    roundCount: z.int(),
+});
+/**
+ * Person investor with round participation labels and count
+ *
+ * @openapiSchema PersonInvestorParticipation
+ * @endpoint GET /v1/entities/detail/person-investors
+ * @usedBySchema PagePersonInvestorParticipationSchema
+ * @contractShape person.investor-participation
+ * @contractRole canonical
+ */
+export const PersonInvestorParticipationSchema = PersonInvestorParticipationSchemaDefinition;
+//# sourceMappingURL=investor-participation.js.map

package/dist/person/list-array-filter.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod/v4";
+/**
+ * Array and range filters for person list endpoints
+ *
+ * @openapiSchema PersonListArrayFilter
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema PersonFilterSchema
+ * @contractShape person.list-array-filter
+ * @contractRole canonical
+ */
+export declare const PersonListArrayFilterSchema: z.ZodObject<{
+    amountInvestedRange: z.ZodOptional<z.ZodNullable<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.ZodNullable<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>>>>>;
+    entityName: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    investedCompany: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    personTitle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    round: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    totalInvestmentCount: z.ZodOptional<z.ZodNullable<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>>>>>;
+    typeRecord: z.ZodOptional<z.ZodNullable<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";
+    }>>>>;
+}, z.core.$strip>;
+export type PersonListArrayFilter = z.infer<typeof PersonListArrayFilterSchema>;
+//# sourceMappingURL=list-array-filter.d.ts.map

package/dist/person/list-array-filter.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";
+import { DecimalRangeSchema } from "../decimal/range.js";
+import { EntityTypeSchema } from "../entity/type.js";
+import { IntRangeSchema } from "../int/range.js";
+/**
+ * Array and range filters for person list endpoints
+ *
+ * @openapiSchema PersonListArrayFilter
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema PersonFilterSchema
+ * @contractShape person.list-array-filter
+ * @contractRole canonical
+ */
+export const PersonListArrayFilterSchema = z.object({
+    amountInvestedRange: z.array(DecimalRangeSchema).nullish(),
+    amountRaisedRange: z.array(DecimalRangeSchema).nullish(),
+    /** Associated entity names. */
+    entityName: z.array(z.string()).nullish(),
+    /** Invested company names. */
+    investedCompany: z.array(z.string()).nullish(),
+    /** Person titles. */
+    personTitle: z.array(z.string()).nullish(),
+    /** Fundraise round labels. */
+    round: z.array(z.string()).nullish(),
+    totalInvestmentCount: z.array(IntRangeSchema).nullish(),
+    /** Associated entity type scope. Omit or use [] for any associated type. */
+    typeRecord: z.array(EntityTypeSchema).nullish(),
+});
+//# sourceMappingURL=list-array-filter.js.map

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

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+export declare const PERSON_LOOKUP_ENDPOINT: "/v1/people/lookup";
+/**
+ * Request-side query params for `GET /v1/people/lookup`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/people/lookup
+ * @contractShape person.lookup-param
+ * @contractRole canonical
+ */
+export declare const PersonLookupParamSchema: z.ZodObject<{
+    includeAddress: z.ZodOptional<z.ZodBoolean>;
+    includeAssociation: z.ZodOptional<z.ZodBoolean>;
+    includePrivate: z.ZodOptional<z.ZodBoolean>;
+    includeUrl: z.ZodOptional<z.ZodBoolean>;
+    location: z.ZodOptional<z.ZodString>;
+    maxAssociations: z.ZodOptional<z.ZodInt>;
+    nameAny: z.ZodOptional<z.ZodString>;
+    nameFull: z.ZodOptional<z.ZodString>;
+    permitMonogram: z.ZodOptional<z.ZodBoolean>;
+    slug: 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 PersonLookupParam = z.infer<typeof PersonLookupParamSchema>;
+//# sourceMappingURL=lookup-param.d.ts.map

package/dist/person/lookup-param.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";
+export const PERSON_LOOKUP_ENDPOINT = "/v1/people/lookup";
+/**
+ * Request-side query params for `GET /v1/people/lookup`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/people/lookup
+ * @contractShape person.lookup-param
+ * @contractRole canonical
+ */
+export const PersonLookupParamSchema = z.object({
+    /** Projection qualifier — include address values (default: true). Set false to omit address array. */
+    includeAddress: z.boolean().optional(),
+    /** Projection qualifier — include association values (default: true). Set false to omit association array. */
+    includeAssociation: z.boolean().optional(),
+    /** Privileged admin readback scope. Includes hidden or off-sitemap people and privileged private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public. */
+    includePrivate: z.boolean().optional(),
+    /** Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array. */
+    includeUrl: z.boolean().optional(),
+    /** Group C — candidate lookup signal: person location (city, state, country). Combine with other group-C signals for bounded search. Mutually exclusive with id and slug; may be combined with url for fallback. */
+    location: z.string().optional(),
+    /** Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40. */
+    maxAssociations: z.int().optional(),
+    /** Group C — candidate lookup signal: loose name match (any of given/family/full). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback. */
+    nameAny: z.string().optional(),
+    /** Group C — candidate lookup signal: person full name. Combine with other group-C signals (nameAny, location, urlDomain) for bounded candidate search. Mutually exclusive with id and slug; may be combined with url for fallback. */
+    nameFull: z.string().optional(),
+    /** Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response. */
+    permitMonogram: z.boolean().optional(),
+    /** Group A — exact person slug (URL-friendly identifier). Mutually exclusive with id, url, and every candidate signal in group C. */
+    slug: z.string().optional(),
+    /** Group B — current person URL to resolve via strict host+path or domain-only match. Mutually exclusive with id and slug; may be combined with group-C candidate signals for URL-first fallback. */
+    url: z.string().optional(),
+    /** Group C — candidate lookup signal: person URL domain (host only, no path). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback. */
+    urlDomain: z.string().optional(),
+    /** URL match mode qualifier: 'hostPath' (strict host + path match, default) or 'domain' (host-only match). Not an identifier on its own. */
+    urlMatchMode: z.string().optional(),
+    /** Optional URL type qualifier for URL lookup (e.g., 'linkedin', 'twitter'). Narrows Group B (url) and Group C (urlDomain) matching. Not an identifier on its own. */
+    urlType: z.string().optional(),
+});
+//# sourceMappingURL=lookup-param.js.map

package/dist/person/natural-search-result.d.ts

@@ -0,0 +1,273 @@
+import { z } from "zod/v4";
+declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
+    interpretation: z.ZodType<{
+        confidence: "HIGH" | "LOW" | "MEDIUM";
+        execution: {
+            modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
+            modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
+        };
+        fallbackUsed: boolean;
+        filter: {
+            arrayFilter?: {
+                amountInvestedRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | null | undefined;
+                amountRaisedRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | null | undefined;
+                entityName?: string[] | null | undefined;
+                investedCompany?: string[] | null | undefined;
+                personTitle?: string[] | null | undefined;
+                round?: string[] | null | undefined;
+                totalInvestmentCount?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | null | undefined;
+                typeRecord?: ("Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service")[] | null | undefined;
+            } | undefined;
+            entityId?: string | null | undefined;
+            entitySlug?: string | null | undefined;
+            firstName?: string | null | undefined;
+            includeAddress?: boolean | null | undefined;
+            includeUrl?: boolean | null | undefined;
+            investorActivity?: {
+                averageAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                largestAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                smallestAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                totalAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                totalInvestmentRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+            } | undefined;
+            isCurrent?: boolean | null | undefined;
+            lastName?: string | null | undefined;
+            letter?: string | null | undefined;
+            role?: string | null | undefined;
+            search?: string | null | undefined;
+            semanticQuery?: string | null | undefined;
+            status?: string | null | undefined;
+        };
+        interpretation: string;
+        sort: {
+            order: {
+                descending: boolean;
+                field: "AMOUNT_INVESTED" | "CREATED_AT" | "FIRST_NAME" | "FULL_NAME" | "GENDER" | "ID" | "LAST_NAME" | "SLUG" | "STATUS" | "TOTAL_INVESTMENTS" | "UPDATED_AT";
+            }[];
+            relevance?: "keyword" | "semantic" | null | undefined;
+        };
+        unsupported?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        confidence: "HIGH" | "LOW" | "MEDIUM";
+        execution: {
+            modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
+            modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
+        };
+        fallbackUsed: boolean;
+        filter: {
+            arrayFilter?: {
+                amountInvestedRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | null | undefined;
+                amountRaisedRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | null | undefined;
+                entityName?: string[] | null | undefined;
+                investedCompany?: string[] | null | undefined;
+                personTitle?: string[] | null | undefined;
+                round?: string[] | null | undefined;
+                totalInvestmentCount?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | null | undefined;
+                typeRecord?: ("Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service")[] | null | undefined;
+            } | undefined;
+            entityId?: string | null | undefined;
+            entitySlug?: string | null | undefined;
+            firstName?: string | null | undefined;
+            includeAddress?: boolean | null | undefined;
+            includeUrl?: boolean | null | undefined;
+            investorActivity?: {
+                averageAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                largestAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                smallestAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                totalAmountInvestedUsdRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+                totalInvestmentRange?: {
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }[] | undefined;
+            } | undefined;
+            isCurrent?: boolean | null | undefined;
+            lastName?: string | null | undefined;
+            letter?: string | null | undefined;
+            role?: string | null | undefined;
+            search?: string | null | undefined;
+            semanticQuery?: string | null | undefined;
+            status?: string | null | undefined;
+        };
+        interpretation: string;
+        sort: {
+            order: {
+                descending: boolean;
+                field: "AMOUNT_INVESTED" | "CREATED_AT" | "FIRST_NAME" | "FULL_NAME" | "GENDER" | "ID" | "LAST_NAME" | "SLUG" | "STATUS" | "TOTAL_INVESTMENTS" | "UPDATED_AT";
+            }[];
+            relevance?: "keyword" | "semantic" | null | undefined;
+        };
+        unsupported?: string | null | undefined;
+    }, unknown>>;
+    result: z.ZodType<{
+        content: {
+            createdAt?: string | null | undefined;
+            gender?: string | null | undefined;
+            id: string;
+            image: {
+                isMonogram: boolean;
+                picture?: string | null | undefined;
+            };
+            lastModifiedAt?: string | null | undefined;
+            nameAlias: {
+                displayable?: boolean | null | undefined;
+                name: string;
+                type?: "formerName" | "maidenName" | "nickname" | "stageName" | null | undefined;
+            }[];
+            nameFirst?: string | null | undefined;
+            nameFull: string;
+            nameLast?: string | null | undefined;
+            nameMiddle?: string | null | undefined;
+            nickname?: string | null | undefined;
+            publicId?: string | null | undefined;
+            semanticMatch?: {
+                computedAt: string;
+                cosineDistance: number;
+                cosineScore: number;
+                modelVersion: string;
+                rank: number;
+                sourceHash: string;
+                sourceId: string;
+                sourceJson: string;
+                sourceText: string;
+                sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
+            } | null | undefined;
+            slug: string;
+            source: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                detail?: string | null | undefined;
+                kind?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            };
+            suffix?: string | null | undefined;
+            text: {
+                expanded?: string | null | undefined;
+                generatedDescription?: string | null | undefined;
+                short?: string | null | undefined;
+            };
+            updatedAt?: string | null | undefined;
+        }[];
+        number: number;
+        size: number;
+        totalElements: number;
+        totalPages: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        content: {
+            createdAt?: string | null | undefined;
+            gender?: string | null | undefined;
+            id: string;
+            image: {
+                isMonogram: boolean;
+                picture?: string | null | undefined;
+            };
+            lastModifiedAt?: string | null | undefined;
+            nameAlias: {
+                displayable?: boolean | null | undefined;
+                name: string;
+                type?: "formerName" | "maidenName" | "nickname" | "stageName" | null | undefined;
+            }[];
+            nameFirst?: string | null | undefined;
+            nameFull: string;
+            nameLast?: string | null | undefined;
+            nameMiddle?: string | null | undefined;
+            nickname?: string | null | undefined;
+            publicId?: string | null | undefined;
+            semanticMatch?: {
+                computedAt: string;
+                cosineDistance: number;
+                cosineScore: number;
+                modelVersion: string;
+                rank: number;
+                sourceHash: string;
+                sourceId: string;
+                sourceJson: string;
+                sourceText: string;
+                sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
+            } | null | undefined;
+            slug: string;
+            source: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                detail?: string | null | undefined;
+                kind?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            };
+            suffix?: string | null | undefined;
+            text: {
+                expanded?: string | null | undefined;
+                generatedDescription?: string | null | undefined;
+                short?: string | null | undefined;
+            };
+            updatedAt?: string | null | undefined;
+        }[];
+        number: number;
+        size: number;
+        totalElements: number;
+        totalPages: number;
+    }, unknown>>;
+}, z.core.$strip>;
+type PersonNaturalSearchResultDefinition = z.infer<typeof PersonNaturalSearchResultSchemaDefinition>;
+/**
+ * Natural-language people search result: planner interpretation plus the canonical person page produced by the person list engine.
+ *
+ * @openapiSchema PersonNaturalSearchResult
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema FederatedSearchSchema
+ * @contractShape person.natural-search-result
+ * @contractRole canonical
+ */
+export declare const PersonNaturalSearchResultSchema: z.ZodType<PersonNaturalSearchResultDefinition>;
+export type PersonNaturalSearchResult = z.infer<typeof PersonNaturalSearchResultSchema>;
+export {};
+//# sourceMappingURL=natural-search-result.d.ts.map

package/dist/person/natural-search-result.js

@@ -0,0 +1,23 @@
+// 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 { PageResultPersonSchema } from "../pagination/schemas.js";
+import { PersonSearchInterpretationSchema } from "./search-interpretation.js";
+const PersonNaturalSearchResultSchemaDefinition = z.object({
+    /** Structured interpretation used to run the people query. */
+    interpretation: PersonSearchInterpretationSchema,
+    /** Person page returned by the canonical person list engine. */
+    result: PageResultPersonSchema,
+});
+/**
+ * Natural-language people search result: planner interpretation plus the canonical person page produced by the person list engine.
+ *
+ * @openapiSchema PersonNaturalSearchResult
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema FederatedSearchSchema
+ * @contractShape person.natural-search-result
+ * @contractRole canonical
+ */
+export const PersonNaturalSearchResultSchema = PersonNaturalSearchResultSchemaDefinition;
+//# sourceMappingURL=natural-search-result.js.map

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

@@ -0,0 +1,114 @@
+import { z } from "zod/v4";
+declare const PersonNaturalSearchSchemaDefinition: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodObject<{
+        arrayFilter: z.ZodOptional<z.ZodObject<{
+            amountInvestedRange: z.ZodOptional<z.ZodNullable<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.ZodNullable<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>>>>>;
+            entityName: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            investedCompany: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            personTitle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            round: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            totalInvestmentCount: z.ZodOptional<z.ZodNullable<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>>>>>;
+            typeRecord: z.ZodOptional<z.ZodNullable<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";
+            }>>>>;
+        }, z.core.$strip>>;
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        entitySlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        firstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        includeAddress: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        includeUrl: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        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>>;
+        isCurrent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        letter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        semanticQuery: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    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 PersonNaturalSearchDefinition = z.infer<typeof PersonNaturalSearchSchemaDefinition>;
+/**
+ * Plain-English people search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.
+ *
+ * @openapiSchema PersonNaturalSearch
+ * @endpoint POST /v1/people/natural-search
+ * @contractShape person.natural-search
+ * @contractRole canonical
+ */
+export declare const PersonNaturalSearchSchema: z.ZodType<PersonNaturalSearchDefinition>;
+export type PersonNaturalSearch = z.infer<typeof PersonNaturalSearchSchema>;
+export {};
+//# sourceMappingURL=natural-search.d.ts.map

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