@aventurevc/api-schemas 0.7.283

package/dist/research/value-shape-type.js

@@ -0,0 +1,27 @@
+// 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";
+/**
+ * Closed write-time value shape token. Shape, not valueType, selects which write fields and validation rules apply.
+ *
+ * @openapiSchema ResearchValueShapeType
+ * @endpoint GET /v1/entities/research/details/types
+ * @usedBySchema ResearchDetailTypeSchema
+ * @contractShape research.value-shape-type
+ * @contractRole canonical
+ */
+export const ResearchValueShapeTypeSchema = z.enum([
+    "acceleratorParticipation",
+    "enumeratedToken",
+    "freeText",
+    "isoCurrencyCode",
+    "monetaryFlow",
+    "monetaryFlowOverPeriod",
+    "monetaryStock",
+    "numericCount",
+    "numericCountOrRange",
+    "numericGrowthRate",
+    "numericRatio",
+    "numericScore",
+    "targetDateAbsolute",
+]);
+//# sourceMappingURL=value-shape-type.js.map

package/dist/resolved/handle.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod/v4";
+declare const ResolvedHandleSchemaDefinition: z.ZodObject<{
+    matchedBy: z.ZodEnum<{
+        EXTERNAL_ID: "EXTERNAL_ID";
+        PUBLIC_ID: "PUBLIC_ID";
+        SLUG: "SLUG";
+        UUID: "UUID";
+    }>;
+    owner: z.ZodObject<{
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>;
+    publicId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type ResolvedHandleDefinition = z.infer<typeof ResolvedHandleSchemaDefinition>;
+/**
+ * Canonical subject a universal-lookup token resolved to. Exactly one of owner.entityId / owner.personId is set. Echoes the subject's canonical public handle and slug. Fetch display fields with GET /v1/entities/detail or GET /v1/people/detail.
+ *
+ * @openapiSchema ResolvedHandle
+ * @endpoint GET /v1/resolve/{token}
+ * @contractShape resolved.handle
+ * @contractRole canonical
+ */
+export declare const ResolvedHandleSchema: z.ZodType<ResolvedHandleDefinition>;
+export type ResolvedHandle = z.infer<typeof ResolvedHandleSchema>;
+export {};
+//# sourceMappingURL=handle.d.ts.map

package/dist/resolved/handle.js

@@ -0,0 +1,27 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
+const ResolvedHandleSchemaDefinition = z.object({
+    /** Which identifier kind matched the token. */
+    matchedBy: z.enum(["PUBLIC_ID", "UUID", "EXTERNAL_ID", "SLUG"]),
+    /** Canonical entity/person owner matched by the token. */
+    owner: EntityPersonOwnerSchema,
+    /** Canonical stable public handle of the resolved subject; null on rows still awaiting handle backfill. */
+    publicId: z.string().nullish(),
+    /** Canonical slug of the resolved subject. */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255)
+        .nullish(),
+});
+/**
+ * Canonical subject a universal-lookup token resolved to. Exactly one of owner.entityId / owner.personId is set. Echoes the subject's canonical public handle and slug. Fetch display fields with GET /v1/entities/detail or GET /v1/people/detail.
+ *
+ * @openapiSchema ResolvedHandle
+ * @endpoint GET /v1/resolve/{token}
+ * @contractShape resolved.handle
+ * @contractRole canonical
+ */
+export const ResolvedHandleSchema = ResolvedHandleSchemaDefinition;
+//# sourceMappingURL=handle.js.map

package/dist/round/label.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod/v4";
+/**
+ * Round participation label - shared by entity and person investor participation
+ *
+ * @openapiSchema RoundLabel
+ * @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/entities/{entityId}
+ * @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/suggestions
+ * @endpoint GET /v1/entities/{entityId}/similar
+ * @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/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 EntityInvestorParticipationSchema
+ * @usedBySchema FundraiseInvestmentAttributionSchema
+ * @usedBySchema PersonInvestorParticipationSchema
+ * @contractShape round.label
+ * @contractRole canonical
+ */
+export declare const RoundLabelSchema: z.ZodObject<{
+    round: z.ZodString;
+}, z.core.$strip>;
+export type RoundLabel = z.infer<typeof RoundLabelSchema>;
+//# sourceMappingURL=label.d.ts.map

package/dist/round/label.js

@@ -0,0 +1,46 @@
+// 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";
+/**
+ * Round participation label - shared by entity and person investor participation
+ *
+ * @openapiSchema RoundLabel
+ * @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/entities/{entityId}
+ * @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/suggestions
+ * @endpoint GET /v1/entities/{entityId}/similar
+ * @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/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 EntityInvestorParticipationSchema
+ * @usedBySchema FundraiseInvestmentAttributionSchema
+ * @usedBySchema PersonInvestorParticipationSchema
+ * @contractShape round.label
+ * @contractRole canonical
+ */
+export const RoundLabelSchema = z.object({
+    round: z.string(),
+});
+//# sourceMappingURL=label.js.map

package/dist/search/duplicate-candidate-score.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod/v4";
+declare const SearchDuplicateCandidateScoreSchemaDefinition: z.ZodObject<{
+    externalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodUUID;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operatingStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publicPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reason: z.ZodArray<z.ZodString>;
+    score: z.ZodInt;
+    slug: z.ZodOptional<z.ZodNullable<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";
+    }>>>;
+}, z.core.$strip>;
+type SearchDuplicateCandidateScoreDefinition = z.infer<typeof SearchDuplicateCandidateScoreSchemaDefinition>;
+/**
+ * Duplicate candidate scoring result. Use id/name/slug/typeRecord/reason to decide whether the candidate is the requested record. score ranks review priority; it does not prove absence.
+ *
+ * @openapiSchema SearchDuplicateCandidateScore
+ * @standardProblemResponse
+ * @usedBySchema DuplicateCreateReviewSchema
+ * @contractShape search.duplicate-candidate-score
+ * @contractRole canonical
+ */
+export declare const SearchDuplicateCandidateScoreSchema: z.ZodType<SearchDuplicateCandidateScoreDefinition>;
+export type SearchDuplicateCandidateScore = z.infer<typeof SearchDuplicateCandidateScoreSchema>;
+export {};
+//# sourceMappingURL=duplicate-candidate-score.d.ts.map

package/dist/search/duplicate-candidate-score.js

@@ -0,0 +1,38 @@
+// 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 { EntityTypeSchema } from "../entity/type.js";
+const SearchDuplicateCandidateScoreSchemaDefinition = z.object({
+    /** Matched external identifier when duplicate scoring used one. */
+    externalId: z.string().nullish(),
+    /** Candidate id to read or update when this candidate is the requested record. */
+    id: z.uuid(),
+    /** Candidate display name from the existing record. */
+    name: z.string().nullish(),
+    /** Current operating status for entity candidates. */
+    operatingStatus: z.string().nullish(),
+    /** Public API/UI path for the candidate when available. */
+    publicPath: z.string().nullish(),
+    /** Match reasons such as name-exact, slug-exact, url-match, url-type, or precomputed-similarity. url-match proves the supplied URL/domain matched; url-type only means the candidate has the same URL category and is review context, not URL identity evidence. */
+    reason: z.array(z.string()),
+    /** Ranking score for duplicate review. It is not an absence proof; a low score can still be the intended record when reason/name/slug/typeRecord match. */
+    score: z.int(),
+    /** Candidate slug from the existing record. */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255)
+        .nullish(),
+    /** Candidate entity type from the existing record. */
+    typeRecord: EntityTypeSchema.nullish(),
+});
+/**
+ * Duplicate candidate scoring result. Use id/name/slug/typeRecord/reason to decide whether the candidate is the requested record. score ranks review priority; it does not prove absence.
+ *
+ * @openapiSchema SearchDuplicateCandidateScore
+ * @standardProblemResponse
+ * @usedBySchema DuplicateCreateReviewSchema
+ * @contractShape search.duplicate-candidate-score
+ * @contractRole canonical
+ */
+export const SearchDuplicateCandidateScoreSchema = SearchDuplicateCandidateScoreSchemaDefinition;
+//# sourceMappingURL=duplicate-candidate-score.js.map

package/dist/search/hit.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const SearchHitSchemaDefinition: z.ZodObject<{
+    relevanceScore: z.ZodNumber;
+    snippet: z.ZodString;
+    title: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+type SearchHitDefinition = z.infer<typeof SearchHitSchemaDefinition>;
+/**
+ * One normalized web-search hit with its title, URL, snippet, and relevance score
+ *
+ * @openapiSchema SearchHit
+ * @endpoint POST /v1/search/web
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.hit
+ * @contractRole canonical
+ */
+export declare const SearchHitSchema: z.ZodType<SearchHitDefinition>;
+export type SearchHit = z.infer<typeof SearchHitSchema>;
+export {};
+//# sourceMappingURL=hit.d.ts.map

package/dist/search/hit.js

@@ -0,0 +1,19 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const SearchHitSchemaDefinition = z.object({
+    relevanceScore: z.number(),
+    snippet: z.string(),
+    title: z.string(),
+    url: z.string(),
+});
+/**
+ * One normalized web-search hit with its title, URL, snippet, and relevance score
+ *
+ * @openapiSchema SearchHit
+ * @endpoint POST /v1/search/web
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.hit
+ * @contractRole canonical
+ */
+export const SearchHitSchema = SearchHitSchemaDefinition;
+//# sourceMappingURL=hit.js.map

package/dist/search/interpretation.d.ts

@@ -0,0 +1,240 @@
+import { z } from "zod/v4";
+declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
+    confidence: z.ZodEnum<{
+        HIGH: "HIGH";
+        LOW: "LOW";
+        MEDIUM: "MEDIUM";
+    }>;
+    execution: z.ZodType<{
+        modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
+        modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
+    }, unknown, z.core.$ZodTypeInternals<{
+        modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
+        modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
+    }, unknown>>;
+    fallbackUsed: z.ZodBoolean;
+    filter: z.ZodType<{
+        acceleratorBrand?: string[] | undefined;
+        acceleratorCohort?: string[] | undefined;
+        acceleratorName?: string[] | undefined;
+        acceleratorStatus?: string[] | undefined;
+        affinity?: string[] | undefined;
+        employeeCountRange?: {
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }[] | undefined;
+        entityId?: string[] | undefined;
+        entityName?: string[] | undefined;
+        featured?: boolean | null | undefined;
+        fundraiseActivity?: {
+            amountInvestedRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            amountRaisedRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            investedCompanyName?: string[] | 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;
+            lastRoundYearRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            round?: string[] | undefined;
+            totalRaisedRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            valuationRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+        } | undefined;
+        hasFundraising?: boolean | null | undefined;
+        headquartersCity?: string[] | undefined;
+        headquartersCountry?: string[] | undefined;
+        headquartersState?: string[] | undefined;
+        industry?: string[] | undefined;
+        letter?: string | null | undefined;
+        location?: string[] | undefined;
+        logoOption?: {
+            sortPriority: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST";
+        } | undefined;
+        mainProduct?: string[] | undefined;
+        operatingStatus?: string[] | undefined;
+        portfolioHeadquartersCity?: string[] | undefined;
+        portfolioHeadquartersCountry?: string[] | undefined;
+        portfolioHeadquartersState?: string[] | undefined;
+        qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+        semanticQuery?: string | null | undefined;
+        slug?: string[] | undefined;
+        stage?: string[] | undefined;
+        suppressNonOperating?: boolean | null | undefined;
+        suppressZeroTotalRaised?: boolean | null | undefined;
+        tag?: string[] | undefined;
+        textSearch?: string | null | undefined;
+        typeCustomer?: string[] | undefined;
+        typeModel?: string[] | undefined;
+        typeOwnership?: string[] | undefined;
+        typeRecord?: ("Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service")[] | undefined;
+        typeRevenue?: string[] | undefined;
+        typeTechnologyUsed?: string[] | undefined;
+        url?: string | null | undefined;
+        urlDomain?: string | null | undefined;
+        urlMatchMode?: "domain" | "hostPath" | undefined;
+        urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
+        yearFoundedRange?: {
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }[] | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        acceleratorBrand?: string[] | undefined;
+        acceleratorCohort?: string[] | undefined;
+        acceleratorName?: string[] | undefined;
+        acceleratorStatus?: string[] | undefined;
+        affinity?: string[] | undefined;
+        employeeCountRange?: {
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }[] | undefined;
+        entityId?: string[] | undefined;
+        entityName?: string[] | undefined;
+        featured?: boolean | null | undefined;
+        fundraiseActivity?: {
+            amountInvestedRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            amountRaisedRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            investedCompanyName?: string[] | 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;
+            lastRoundYearRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            round?: string[] | undefined;
+            totalRaisedRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+            valuationRange?: {
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }[] | undefined;
+        } | undefined;
+        hasFundraising?: boolean | null | undefined;
+        headquartersCity?: string[] | undefined;
+        headquartersCountry?: string[] | undefined;
+        headquartersState?: string[] | undefined;
+        industry?: string[] | undefined;
+        letter?: string | null | undefined;
+        location?: string[] | undefined;
+        logoOption?: {
+            sortPriority: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST";
+        } | undefined;
+        mainProduct?: string[] | undefined;
+        operatingStatus?: string[] | undefined;
+        portfolioHeadquartersCity?: string[] | undefined;
+        portfolioHeadquartersCountry?: string[] | undefined;
+        portfolioHeadquartersState?: string[] | undefined;
+        qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+        semanticQuery?: string | null | undefined;
+        slug?: string[] | undefined;
+        stage?: string[] | undefined;
+        suppressNonOperating?: boolean | null | undefined;
+        suppressZeroTotalRaised?: boolean | null | undefined;
+        tag?: string[] | undefined;
+        textSearch?: string | null | undefined;
+        typeCustomer?: string[] | undefined;
+        typeModel?: string[] | undefined;
+        typeOwnership?: string[] | undefined;
+        typeRecord?: ("Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service")[] | undefined;
+        typeRevenue?: string[] | undefined;
+        typeTechnologyUsed?: string[] | undefined;
+        url?: string | null | undefined;
+        urlDomain?: string | null | undefined;
+        urlMatchMode?: "domain" | "hostPath" | undefined;
+        urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
+        yearFoundedRange?: {
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }[] | undefined;
+    }, unknown>>;
+    interpretation: z.ZodString;
+    sort: z.ZodType<{
+        order: {
+            descending: boolean;
+            field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+        }[];
+        relevance?: "keyword" | "semantic" | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        order: {
+            descending: boolean;
+            field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+        }[];
+        relevance?: "keyword" | "semantic" | null | undefined;
+    }, unknown>>;
+    unsupported: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type SearchInterpretationDefinition = z.infer<typeof SearchInterpretationSchemaDefinition>;
+/**
+ * Structured interpretation of a natural-language entity search: canonical filter, sort, confidence, and any unsupported constraint the planner could not translate.
+ *
+ * @openapiSchema SearchInterpretation
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema NaturalSearchResultSchema
+ * @contractShape search.interpretation
+ * @contractRole canonical
+ */
+export declare const SearchInterpretationSchema: z.ZodType<SearchInterpretationDefinition>;
+export type SearchInterpretation = z.infer<typeof SearchInterpretationSchema>;
+export {};
+//# sourceMappingURL=interpretation.d.ts.map

package/dist/search/interpretation.js

@@ -0,0 +1,35 @@
+// 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 { ConfidenceSchema } from "../confidence/confidence.js";
+import { EntityListFilterSchema } from "../entity/list-filter.js";
+import { SearchModeExecutionSchema } from "./mode-execution.js";
+import { SearchOrderingEntityFilterSortableSchema } from "./ordering-entity-filter-sortable.js";
+const SearchInterpretationSchemaDefinition = z.object({
+    /** Planner confidence in the structured interpretation. */
+    confidence: ConfidenceSchema,
+    /** Requested and executed search strategy. */
+    execution: SearchModeExecutionSchema,
+    /** True when the semantic fallback replaced an untranslatable planner result with a semantic search over the original query. */
+    fallbackUsed: z.boolean(),
+    /** Canonical entity filter generated from the natural-language query. */
+    filter: EntityListFilterSchema,
+    /** Human-readable summary of how the query was interpreted. */
+    interpretation: z.string(),
+    /** Ordering applied to the result page: the relevance rank that ran first, if any, then the sortable-column terms. */
+    sort: SearchOrderingEntityFilterSortableSchema,
+    /** Constraint the planner could not translate into the canonical EntityFilter contract; null when every material constraint was supported. */
+    unsupported: z.string().nullish(),
+});
+/**
+ * Structured interpretation of a natural-language entity search: canonical filter, sort, confidence, and any unsupported constraint the planner could not translate.
+ *
+ * @openapiSchema SearchInterpretation
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema NaturalSearchResultSchema
+ * @contractShape search.interpretation
+ * @contractRole canonical
+ */
+export const SearchInterpretationSchema = SearchInterpretationSchemaDefinition;
+//# sourceMappingURL=interpretation.js.map

package/dist/search/mode-execution.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod/v4";
+declare const SearchModeExecutionSchemaDefinition: z.ZodObject<{
+    modeRequested: z.ZodEnum<{
+        auto: "auto";
+        exact: "exact";
+        keyword: "keyword";
+        natural: "natural";
+        semantic: "semantic";
+    }>;
+    modeUsed: z.ZodEnum<{
+        auto: "auto";
+        exact: "exact";
+        keyword: "keyword";
+        natural: "natural";
+        semantic: "semantic";
+    }>;
+}, z.core.$strip>;
+type SearchModeExecutionDefinition = z.infer<typeof SearchModeExecutionSchemaDefinition>;
+/**
+ * Search strategy requested by the caller and executed by the canonical engine.
+ *
+ * @openapiSchema SearchModeExecution
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema FederatedSearchProvenanceSchema
+ * @usedBySchema PersonSearchInterpretationSchema
+ * @usedBySchema SearchInterpretationSchema
+ * @contractShape search.mode-execution
+ * @contractRole canonical
+ */
+export declare const SearchModeExecutionSchema: z.ZodType<SearchModeExecutionDefinition>;
+export type SearchModeExecution = z.infer<typeof SearchModeExecutionSchema>;
+export {};
+//# sourceMappingURL=mode-execution.d.ts.map

package/dist/search/mode-execution.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 { SearchModeSchema } from "./mode.js";
+const SearchModeExecutionSchemaDefinition = z.object({
+    /** Search mode requested by the caller. */
+    modeRequested: SearchModeSchema,
+    /** Search mode executed by the canonical engine. */
+    modeUsed: SearchModeSchema,
+});
+/**
+ * Search strategy requested by the caller and executed by the canonical engine.
+ *
+ * @openapiSchema SearchModeExecution
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema FederatedSearchProvenanceSchema
+ * @usedBySchema PersonSearchInterpretationSchema
+ * @usedBySchema SearchInterpretationSchema
+ * @contractShape search.mode-execution
+ * @contractRole canonical
+ */
+export const SearchModeExecutionSchema = SearchModeExecutionSchemaDefinition;
+//# sourceMappingURL=mode-execution.js.map