@aventurevc/api-schemas 0.8.90 → 0.8.92

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

@@ -147,6 +147,257 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
         };
         unsupported?: string | null | undefined;
     }, unknown>>;
+    investment: z.ZodArray<z.ZodType<{
+        evidence: {
+            fundManagerRelationshipSource?: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            } | null | undefined;
+            fundraiseTransaction: {
+                amountRaised?: number | null | undefined;
+                createdAt?: string | null | undefined;
+                currency?: string | null | undefined;
+                dataConfidence?: "High" | "Low" | "Medium" | "Verified" | null | undefined;
+                dateAnnounced?: string | null | undefined;
+                dateFundingComplete?: string | null | undefined;
+                dateInvestorExit?: string | null | undefined;
+                entity?: {
+                    core: {
+                        defaultCurrency?: string | null | undefined;
+                        foundedYear?: number | null | undefined;
+                        id: string;
+                        image: {
+                            isMonogram: boolean;
+                            logo?: string | null | undefined;
+                            logoSquare?: string | null | undefined;
+                        };
+                        lastModifiedAt?: string | null | undefined;
+                        nameAlias: {
+                            displayable?: boolean | null | undefined;
+                            name: string;
+                            type?: "alternativeDba" | "relatedLegal" | null | undefined;
+                        }[];
+                        nameBrand: string;
+                        nameLegal?: string | null | undefined;
+                        operatingStatus?: string | null | undefined;
+                        publicId?: string | null | undefined;
+                        publicUrl?: string | null | undefined;
+                        sitemap?: {
+                            hasAcquisitions?: boolean | undefined;
+                            hasAnalysis: boolean;
+                            hasEmployees: boolean;
+                            hasFundraising: boolean;
+                            hasNews: boolean;
+                            productServiceSlug: string[];
+                        } | null | undefined;
+                        slug: string;
+                        typeRecord: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service";
+                        updatedAt?: string | null | undefined;
+                    };
+                    fundingDetail?: {
+                        currency?: string | null | undefined;
+                        fundingRoundCount: number;
+                        investorCount: number;
+                        latestValuation?: number | null | undefined;
+                        mostRecentAmount?: number | null | undefined;
+                        mostRecentDate?: string | null | undefined;
+                        stage?: "Acquired" | "Acquired Subsidiary" | "Angel" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Pre-Seed" | "Public" | "Seed" | "Series A" | "Series B" | "Series C" | "Series D" | "Series E" | "Series F" | "Series G" | "Series H" | "Series I" | "Series J" | "Series K" | "Series L" | "Series M" | "Series N" | "Series O" | "Series P" | "Series Q" | "Series R" | "Series S" | "Series T" | "Series U" | "Series V" | "Series W" | "Series X" | "Series Y" | "Series Z" | null | undefined;
+                        totalRaised: number;
+                    } | null | undefined;
+                } | null | undefined;
+                id: string;
+                investorAttribution?: {
+                    amountInvested?: number | null | undefined;
+                    attributionType: "direct" | "managedFund";
+                    beneficialEntityId?: string | null | undefined;
+                    fundManagerRelationshipId?: number | null | undefined;
+                    joinId: string;
+                    leadInvestor: boolean;
+                    recordedEntityId?: string | null | undefined;
+                    round?: {
+                        round: string;
+                    } | null | undefined;
+                    transactionId: string;
+                } | null | undefined;
+                investorCount?: number | null | undefined;
+                round?: string | null | undefined;
+                sourceAttribution: {
+                    amountInvested?: number | null | undefined;
+                    attributionType: "direct" | "managedFund";
+                    beneficialEntityId?: string | null | undefined;
+                    fundManagerRelationshipId?: number | null | undefined;
+                    joinId: string;
+                    leadInvestor: boolean;
+                    recordedEntityId?: string | null | undefined;
+                    round?: {
+                        round: string;
+                    } | null | undefined;
+                    transactionId: string;
+                }[];
+                updatedAt?: string | null | undefined;
+                valuationPostMoney?: number | null | undefined;
+                valuationPreMoney?: number | null | undefined;
+            };
+            fundraiseTransactionSource?: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            } | null | undefined;
+            investorJoinSource?: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            } | null | undefined;
+        };
+        investor: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        semanticMatch?: {
+            computedAt: string;
+            cosineDistance: number;
+            cosineScore: number;
+            modelVersion: string;
+            rank: number;
+            sourceHash: string;
+            sourceId: string;
+            sourceJson: string;
+            sourceText: string;
+            sourceType: string;
+        } | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        evidence: {
+            fundManagerRelationshipSource?: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            } | null | undefined;
+            fundraiseTransaction: {
+                amountRaised?: number | null | undefined;
+                createdAt?: string | null | undefined;
+                currency?: string | null | undefined;
+                dataConfidence?: "High" | "Low" | "Medium" | "Verified" | null | undefined;
+                dateAnnounced?: string | null | undefined;
+                dateFundingComplete?: string | null | undefined;
+                dateInvestorExit?: string | null | undefined;
+                entity?: {
+                    core: {
+                        defaultCurrency?: string | null | undefined;
+                        foundedYear?: number | null | undefined;
+                        id: string;
+                        image: {
+                            isMonogram: boolean;
+                            logo?: string | null | undefined;
+                            logoSquare?: string | null | undefined;
+                        };
+                        lastModifiedAt?: string | null | undefined;
+                        nameAlias: {
+                            displayable?: boolean | null | undefined;
+                            name: string;
+                            type?: "alternativeDba" | "relatedLegal" | null | undefined;
+                        }[];
+                        nameBrand: string;
+                        nameLegal?: string | null | undefined;
+                        operatingStatus?: string | null | undefined;
+                        publicId?: string | null | undefined;
+                        publicUrl?: string | null | undefined;
+                        sitemap?: {
+                            hasAcquisitions?: boolean | undefined;
+                            hasAnalysis: boolean;
+                            hasEmployees: boolean;
+                            hasFundraising: boolean;
+                            hasNews: boolean;
+                            productServiceSlug: string[];
+                        } | null | undefined;
+                        slug: string;
+                        typeRecord: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service";
+                        updatedAt?: string | null | undefined;
+                    };
+                    fundingDetail?: {
+                        currency?: string | null | undefined;
+                        fundingRoundCount: number;
+                        investorCount: number;
+                        latestValuation?: number | null | undefined;
+                        mostRecentAmount?: number | null | undefined;
+                        mostRecentDate?: string | null | undefined;
+                        stage?: "Acquired" | "Acquired Subsidiary" | "Angel" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Pre-Seed" | "Public" | "Seed" | "Series A" | "Series B" | "Series C" | "Series D" | "Series E" | "Series F" | "Series G" | "Series H" | "Series I" | "Series J" | "Series K" | "Series L" | "Series M" | "Series N" | "Series O" | "Series P" | "Series Q" | "Series R" | "Series S" | "Series T" | "Series U" | "Series V" | "Series W" | "Series X" | "Series Y" | "Series Z" | null | undefined;
+                        totalRaised: number;
+                    } | null | undefined;
+                } | null | undefined;
+                id: string;
+                investorAttribution?: {
+                    amountInvested?: number | null | undefined;
+                    attributionType: "direct" | "managedFund";
+                    beneficialEntityId?: string | null | undefined;
+                    fundManagerRelationshipId?: number | null | undefined;
+                    joinId: string;
+                    leadInvestor: boolean;
+                    recordedEntityId?: string | null | undefined;
+                    round?: {
+                        round: string;
+                    } | null | undefined;
+                    transactionId: string;
+                } | null | undefined;
+                investorCount?: number | null | undefined;
+                round?: string | null | undefined;
+                sourceAttribution: {
+                    amountInvested?: number | null | undefined;
+                    attributionType: "direct" | "managedFund";
+                    beneficialEntityId?: string | null | undefined;
+                    fundManagerRelationshipId?: number | null | undefined;
+                    joinId: string;
+                    leadInvestor: boolean;
+                    recordedEntityId?: string | null | undefined;
+                    round?: {
+                        round: string;
+                    } | null | undefined;
+                    transactionId: string;
+                }[];
+                updatedAt?: string | null | undefined;
+                valuationPostMoney?: number | null | undefined;
+                valuationPreMoney?: number | null | undefined;
+            };
+            fundraiseTransactionSource?: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            } | null | undefined;
+            investorJoinSource?: {
+                changedAt?: string | null | undefined;
+                dataSourceUpdatedAt?: string | null | undefined;
+                pendingApproval?: number | null | undefined;
+                sourceId?: string | null | undefined;
+                status?: string | null | undefined;
+            } | null | undefined;
+        };
+        investor: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        semanticMatch?: {
+            computedAt: string;
+            cosineDistance: number;
+            cosineScore: number;
+            modelVersion: string;
+            rank: number;
+            sourceHash: string;
+            sourceId: string;
+            sourceJson: string;
+            sourceText: string;
+            sourceType: string;
+        } | null | undefined;
+    }, unknown>>>;
     result: z.ZodType<{
         content: {
             createdAt?: string | null | undefined;
@@ -240,6 +491,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
         totalElements: number;
         totalPages: number;
     }, unknown>>;
+    searchRequestId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
 }, z.core.$strip>;
 type PersonNaturalSearchResultDefinition = z.infer<typeof PersonNaturalSearchResultSchemaDefinition>;
 /**

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

@@ -2,11 +2,16 @@
 import { z } from "zod/v4";
 import { PageResultPersonSchema } from "../pagination/schemas.js";
 import { PersonSearchInterpretationSchema } from "./search-interpretation.js";
+import { SearchInvestmentSchema } from "../search/investment.js";
 const PersonNaturalSearchResultSchemaDefinition = z.object({
     /** Structured interpretation used to run the people query. */
     interpretation: PersonSearchInterpretationSchema,
+    /** Personal investment participation supporting the returned people. Firm portfolio activity is never attributed to employees. Empty for other question intents. */
+    investment: z.array(SearchInvestmentSchema),
     /** Person page returned by the canonical person list engine. */
     result: PageResultPersonSchema,
+    /** Id of this search's stored record; send it with createSearchInteraction to record which results the user selected or opened. Null when the search was not recorded. */
+    searchRequestId: z.uuid().nullish(),
 });
 /**
  * Natural-language people search result: planner interpretation plus the canonical person page produced by the person list engine.

package/dist/round/label.d.ts

@@ -27,6 +27,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/natural/people
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityInvestorParticipationSchema
  * @usedBySchema FundraiseInvestmentAttributionSchema

package/dist/round/label.js

@@ -28,6 +28,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/natural/people
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityInvestorParticipationSchema
  * @usedBySchema FundraiseInvestmentAttributionSchema

package/dist/search/answer-citation.d.ts

@@ -1,7 +1,12 @@
 import { z } from "zod/v4";
 declare const SearchAnswerCitationSchemaDefinition: z.ZodObject<{
     entityId: z.ZodUUID;
-    source: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+    source: z.ZodUnion<readonly [z.ZodEnum<{
+        entityRecord: "entityRecord";
+        fundraiseTransaction: "fundraiseTransaction";
+        newsArticle: "newsArticle";
+        researchSnippet: "researchSnippet";
+    }>, z.ZodString]>;
     sourceId: z.ZodString;
 }, z.core.$strip>;
 type SearchAnswerCitationDefinition = z.infer<typeof SearchAnswerCitationSchemaDefinition>;

package/dist/search/answer-citation.js

@@ -6,7 +6,7 @@ const SearchAnswerCitationSchemaDefinition = z.object({
     entityId: z.uuid(),
     /** Record that owns the cited evidence. */
     source: SearchEvidenceSourceSchema,
-    /** Entity id for `entityRecord`, else the snippet or news article id from `passage`. */
+    /** Entity id for `entityRecord`, snippet or news article id from `passage`, or the recorded round id for `fundraiseTransaction`. */
     sourceId: z.string(),
 });
 /**

package/dist/search/evidence-source.d.ts

@@ -1,12 +1,6 @@
 import { z } from "zod/v4";
-declare const SearchEvidenceSourceSchemaDefinition: z.ZodUnion<readonly [z.ZodEnum<{
-    entityRecord: "entityRecord";
-    newsArticle: "newsArticle";
-    researchSnippet: "researchSnippet";
-}>, z.ZodString]>;
-type SearchEvidenceSourceDefinition = z.infer<typeof SearchEvidenceSourceSchemaDefinition>;
 /**
- * Owner of search evidence: `entityRecord` is the entity's structured record, `researchSnippet` an entity research snippet, `newsArticle` a news article linked to the entity.
+ * Owner of search evidence: `entityRecord` is the entity's structured record, `researchSnippet` an entity research snippet, `newsArticle` a news article linked to the entity; `fundraiseTransaction` a recorded investment round with investor attribution.
  *
  * @openapiSchema SearchEvidenceSource
  * @endpoint GET /v1/search/link
@@ -21,7 +15,11 @@ type SearchEvidenceSourceDefinition = z.infer<typeof SearchEvidenceSourceSchemaD
  * @contractShape search.evidence-source
  * @contractRole canonical
  */
-export declare const SearchEvidenceSourceSchema: z.ZodType<SearchEvidenceSourceDefinition>;
+export declare const SearchEvidenceSourceSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    entityRecord: "entityRecord";
+    fundraiseTransaction: "fundraiseTransaction";
+    newsArticle: "newsArticle";
+    researchSnippet: "researchSnippet";
+}>, z.ZodString]>;
 export type SearchEvidenceSource = z.infer<typeof SearchEvidenceSourceSchema>;
-export {};
 //# sourceMappingURL=evidence-source.d.ts.map

package/dist/search/evidence-source.js

@@ -1,11 +1,7 @@
 // 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 SearchEvidenceSourceSchemaDefinition = z.union([
-    z.enum(["entityRecord", "researchSnippet", "newsArticle"]),
-    z.string(),
-]);
 /**
- * Owner of search evidence: `entityRecord` is the entity's structured record, `researchSnippet` an entity research snippet, `newsArticle` a news article linked to the entity.
+ * Owner of search evidence: `entityRecord` is the entity's structured record, `researchSnippet` an entity research snippet, `newsArticle` a news article linked to the entity; `fundraiseTransaction` a recorded investment round with investor attribution.
  *
  * @openapiSchema SearchEvidenceSource
  * @endpoint GET /v1/search/link
@@ -20,5 +16,8 @@ const SearchEvidenceSourceSchemaDefinition = z.union([
  * @contractShape search.evidence-source
  * @contractRole canonical
  */
-export const SearchEvidenceSourceSchema = SearchEvidenceSourceSchemaDefinition;
+export const SearchEvidenceSourceSchema = z.union([
+    z.enum(["entityRecord", "researchSnippet", "newsArticle", "fundraiseTransaction"]),
+    z.string(),
+]);
 //# sourceMappingURL=evidence-source.js.map

package/dist/search/interpretation.d.ts

@@ -37,6 +37,8 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
                 min?: number | null | undefined;
             }[] | undefined;
             investedCompanyName?: string[] | undefined;
+            investedIndustry?: string[] | undefined;
+            investedRound?: string[] | undefined;
             investorActivity?: {
                 averageAmountInvestedUsdRange?: {
                     max?: number | null | undefined;
@@ -64,6 +66,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
                 max?: number | null | undefined;
                 min?: number | null | undefined;
             }[] | undefined;
+            rankByInvestmentActivity?: boolean | null | undefined;
             round?: string[] | undefined;
             totalRaisedRange?: {
                 max?: number | null | undefined;
@@ -136,6 +139,8 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
                 min?: number | null | undefined;
             }[] | undefined;
             investedCompanyName?: string[] | undefined;
+            investedIndustry?: string[] | undefined;
+            investedRound?: string[] | undefined;
             investorActivity?: {
                 averageAmountInvestedUsdRange?: {
                     max?: number | null | undefined;
@@ -163,6 +168,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
                 max?: number | null | undefined;
                 min?: number | null | undefined;
             }[] | undefined;
+            rankByInvestmentActivity?: boolean | null | undefined;
             round?: string[] | undefined;
             totalRaisedRange?: {
                 max?: number | null | undefined;