@aventurevc/api-schemas 0.8.62 → 0.8.63

package/dist/natural/search-result.js

@@ -1,12 +1,24 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
+import { EntityListSchema } from "../entity/list.js";
+import { EntitySimilarityResultSchema } from "../entity/similarity-result.js";
 import { PageResultEntityListSchema } from "../pagination/schemas.js";
+import { SearchAnswerSchema } from "../search/answer.js";
 import { SearchInterpretationSchema } from "../search/interpretation.js";
+import { SearchPassageSchema } from "../search/passage.js";
 const NaturalSearchResultSchemaDefinition = z.object({
+    /** Written answer grounded in the subject, peer, and result records and the passages; null unless the request asks for the `synthesis` layer. */
+    answer: SearchAnswerSchema.nullish(),
     /** Structured interpretation used to run the entity list query. */
     interpretation: SearchInterpretationSchema,
+    /** Passages that best answer the question, ranked by score; empty unless the request asks for the `passage` layer. */
+    passage: z.array(SearchPassageSchema),
+    /** Curated competitors of the single subject entity for `peer` questions; semantic look-alikes are the result page. Empty otherwise. */
+    peer: z.array(EntitySimilarityResultSchema),
     /** Entity list page returned by the canonical entity list engine. */
     result: PageResultEntityListSchema,
+    /** Entities the question is about, one per resolved subject name, in query order; empty when the question names none or none resolves. */
+    subject: z.array(EntityListSchema),
 });
 /**
  * Natural-language entity search result: planner interpretation plus the canonical entity list page produced by EntityListService.

package/dist/news/detail.d.ts

@@ -1,14 +1,5 @@
 import { z } from "zod/v4";
-/**
- * Canonical news detail owner
- *
- * @openapiSchema NewsDetail
- * @endpoint GET /v1/news/lookup
- * @endpoint GET /v1/news/{newsId}
- * @contractShape news.detail
- * @contractRole canonical
- */
-export declare const NewsDetailSchema: z.ZodObject<{
+declare const NewsDetailSchemaDefinition: z.ZodObject<{
     content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     core: z.ZodType<{
         author?: string | null | undefined;
@@ -80,5 +71,17 @@ export declare const NewsDetailSchema: z.ZodObject<{
         updatedAt: string;
     }, unknown>>>;
 }, z.core.$strip>;
+type NewsDetailDefinition = z.infer<typeof NewsDetailSchemaDefinition>;
+/**
+ * Canonical news detail owner
+ *
+ * @openapiSchema NewsDetail
+ * @endpoint GET /v1/news/lookup
+ * @endpoint GET /v1/news/{newsId}
+ * @contractShape news.detail
+ * @contractRole canonical
+ */
+export declare const NewsDetailSchema: z.ZodType<NewsDetailDefinition>;
 export type NewsDetail = z.infer<typeof NewsDetailSchema>;
+export {};
 //# sourceMappingURL=detail.d.ts.map

package/dist/news/detail.js

@@ -3,16 +3,7 @@ import { z } from "zod/v4";
 import { NewsSchema } from "./news.js";
 import { NewsResolvedEntityLinkSchema } from "./resolved-entity-link.js";
 import { NewsResolvedPersonLinkSchema } from "./resolved-person-link.js";
-/**
- * Canonical news detail owner
- *
- * @openapiSchema NewsDetail
- * @endpoint GET /v1/news/lookup
- * @endpoint GET /v1/news/{newsId}
- * @contractShape news.detail
- * @contractRole canonical
- */
-export const NewsDetailSchema = z.object({
+const NewsDetailSchemaDefinition = z.object({
     content: z.string().nullish(),
     core: NewsSchema,
     /** Resolved entity mentions — read-only display projections. News mutations attach entities only via flat entityJoinId values, never these nested objects. */
@@ -22,4 +13,14 @@ export const NewsDetailSchema = z.object({
     /** Resolved person mentions — read-only display projections. News mutations attach people only via flat personId/personSlug values, never these nested objects. */
     personMentionResolved: z.array(NewsResolvedPersonLinkSchema),
 });
+/**
+ * Canonical news detail owner
+ *
+ * @openapiSchema NewsDetail
+ * @endpoint GET /v1/news/lookup
+ * @endpoint GET /v1/news/{newsId}
+ * @contractShape news.detail
+ * @contractRole canonical
+ */
+export const NewsDetailSchema = NewsDetailSchemaDefinition;
 //# sourceMappingURL=detail.js.map

package/dist/openapi-component-manifest.js

@@ -789,15 +789,26 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     ResolvedHandle: { modulePath: "resolved/handle", schemaName: "ResolvedHandleSchema" },
     RoundLabel: { modulePath: "round/label", schemaName: "RoundLabelSchema" },
     Search: { modulePath: "search/search", schemaName: "SearchSchema" },
+    SearchAnswer: { modulePath: "search/answer", schemaName: "SearchAnswerSchema" },
+    SearchAnswerCitation: {
+        modulePath: "search/answer-citation",
+        schemaName: "SearchAnswerCitationSchema",
+    },
     SearchDuplicateCandidateScore: {
         modulePath: "search/duplicate-candidate-score",
         schemaName: "SearchDuplicateCandidateScoreSchema",
     },
+    SearchEvidenceSource: {
+        modulePath: "search/evidence-source",
+        schemaName: "SearchEvidenceSourceSchema",
+    },
     SearchHit: { modulePath: "search/hit", schemaName: "SearchHitSchema" },
+    SearchIntent: { modulePath: "search/intent", schemaName: "SearchIntentSchema" },
     SearchInterpretation: {
         modulePath: "search/interpretation",
         schemaName: "SearchInterpretationSchema",
     },
+    SearchLayer: { modulePath: "search/layer", schemaName: "SearchLayerSchema" },
     SearchMode: { modulePath: "search/mode", schemaName: "SearchModeSchema" },
     SearchModeExecution: {
         modulePath: "search/mode-execution",
@@ -811,6 +822,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "search/ordering-person-sort-field",
         schemaName: "SearchOrderingPersonSortFieldSchema",
     },
+    SearchPassage: { modulePath: "search/passage", schemaName: "SearchPassageSchema" },
     SearchRelevance: { modulePath: "search/relevance", schemaName: "SearchRelevanceSchema" },
     SecCompany: { modulePath: "sec/company", schemaName: "SecCompanySchema" },
     SlugLocation: { modulePath: "slug/location", schemaName: "SlugLocationSchema" },

package/dist/pagination/schemas.d.ts

@@ -261,11 +261,15 @@ declare const PageEntitySchemaDefinition: z.ZodObject<{
         defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         id: z.ZodUUID;
-        image: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        image: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
         lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         nameAlias: z.ZodArray<z.ZodType<{
             displayable?: boolean | null | undefined;
@@ -563,11 +567,15 @@ declare const PageEntityDetailSchemaDefinition: z.ZodObject<{
             defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
             id: z.ZodUUID;
-            image: z.ZodObject<{
-                isMonogram: z.ZodBoolean;
-                logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            }, z.core.$strip>;
+            image: z.ZodType<{
+                isMonogram: boolean;
+                logo?: string | null | undefined;
+                logoSquare?: string | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                isMonogram: boolean;
+                logo?: string | null | undefined;
+                logoSquare?: string | null | undefined;
+            }, unknown>>;
             lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
             nameAlias: z.ZodArray<z.ZodType<{
                 displayable?: boolean | null | undefined;
@@ -5582,11 +5590,15 @@ declare const PageEntityPersonAssociationSchemaDefinition: z.ZodObject<{
             updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         }, z.core.$strip>>;
         entityId: z.ZodUUID;
-        entityLogo: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        entityLogo: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
         entityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         entityOperatingStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         entitySlug: z.ZodString;
@@ -5686,10 +5698,13 @@ declare const PageEntityPersonAssociationSchemaDefinition: z.ZodObject<{
             updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         }, z.core.$strip>>;
         personId: z.ZodUUID;
-        personImage: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            picture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        personImage: z.ZodType<{
+            isMonogram: boolean;
+            picture?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            picture?: string | null | undefined;
+        }, unknown>>;
         personName: z.ZodString;
         personSlug: z.ZodString;
         personUrlLink: z.ZodArray<z.ZodType<{

package/dist/person/detail.d.ts

@@ -53,11 +53,15 @@ declare const PersonDetailSchemaDefinition: z.ZodObject<{
             updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         }, z.core.$strip>>;
         entityId: z.ZodUUID;
-        entityLogo: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        entityLogo: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
         entityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         entityOperatingStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         entitySlug: z.ZodString;
@@ -157,10 +161,13 @@ declare const PersonDetailSchemaDefinition: z.ZodObject<{
             updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         }, z.core.$strip>>;
         personId: z.ZodUUID;
-        personImage: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            picture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        personImage: z.ZodType<{
+            isMonogram: boolean;
+            picture?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            picture?: string | null | undefined;
+        }, unknown>>;
         personName: z.ZodString;
         personSlug: z.ZodString;
         personUrlLink: z.ZodArray<z.ZodType<{

package/dist/person/graph-career-context.d.ts

@@ -51,11 +51,15 @@ declare const PersonGraphCareerContextSchemaDefinition: z.ZodObject<{
             defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
             id: z.ZodUUID;
-            image: z.ZodObject<{
-                isMonogram: z.ZodBoolean;
-                logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            }, z.core.$strip>;
+            image: z.ZodType<{
+                isMonogram: boolean;
+                logo?: string | null | undefined;
+                logoSquare?: string | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                isMonogram: boolean;
+                logo?: string | null | undefined;
+                logoSquare?: string | null | undefined;
+            }, unknown>>;
             lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
             nameAlias: z.ZodArray<z.ZodType<{
                 displayable?: boolean | null | undefined;

package/dist/person/graph-co-investor.d.ts

@@ -27,11 +27,15 @@ declare const PersonGraphCoInvestorSchemaDefinition: z.ZodObject<{
         defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         id: z.ZodUUID;
-        image: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        image: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
         lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         nameAlias: z.ZodArray<z.ZodType<{
             displayable?: boolean | null | undefined;

package/dist/person/graph-member.d.ts

@@ -2,10 +2,13 @@ import { z } from "zod/v4";
 declare const PersonGraphMemberSchemaDefinition: z.ZodObject<{
     isCurrent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     personId: z.ZodUUID;
-    personImage: z.ZodObject<{
-        isMonogram: z.ZodBoolean;
-        picture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>;
+    personImage: z.ZodType<{
+        isMonogram: boolean;
+        picture?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        isMonogram: boolean;
+        picture?: string | null | undefined;
+    }, unknown>>;
     personName: z.ZodString;
     personSlug: z.ZodString;
     titleName: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/person/graph-similar-entity.d.ts

@@ -5,11 +5,15 @@ declare const PersonGraphSimilarEntitySchemaDefinition: z.ZodObject<{
             defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
             id: z.ZodUUID;
-            image: z.ZodObject<{
-                isMonogram: z.ZodBoolean;
-                logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            }, z.core.$strip>;
+            image: z.ZodType<{
+                isMonogram: boolean;
+                logo?: string | null | undefined;
+                logoSquare?: string | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                isMonogram: boolean;
+                logo?: string | null | undefined;
+                logoSquare?: string | null | undefined;
+            }, unknown>>;
             lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
             nameAlias: z.ZodArray<z.ZodType<{
                 displayable?: boolean | null | undefined;

package/dist/person/image.d.ts

@@ -1,4 +1,9 @@
 import { z } from "zod/v4";
+declare const PersonImageSchemaDefinition: z.ZodObject<{
+    isMonogram: z.ZodBoolean;
+    picture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type PersonImageDefinition = z.infer<typeof PersonImageSchemaDefinition>;
 /**
  * Read projection: person image fields for detail/list responses
  *
@@ -33,9 +38,7 @@ import { z } from "zod/v4";
  * @contractShape person.image
  * @contractRole canonical
  */
-export declare const PersonImageSchema: z.ZodObject<{
-    isMonogram: z.ZodBoolean;
-    picture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+export declare const PersonImageSchema: z.ZodType<PersonImageDefinition>;
 export type PersonImage = z.infer<typeof PersonImageSchema>;
+export {};
 //# sourceMappingURL=image.d.ts.map

package/dist/person/image.js

@@ -1,5 +1,10 @@
 // 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 PersonImageSchemaDefinition = z.object({
+    /** Whether person image monogram */
+    isMonogram: z.boolean(),
+    picture: z.string().nullish(),
+});
 /**
  * Read projection: person image fields for detail/list responses
  *
@@ -34,9 +39,5 @@ import { z } from "zod/v4";
  * @contractShape person.image
  * @contractRole canonical
  */
-export const PersonImageSchema = z.object({
-    /** Whether person image monogram */
-    isMonogram: z.boolean(),
-    picture: z.string().nullish(),
-});
+export const PersonImageSchema = PersonImageSchemaDefinition;
 //# sourceMappingURL=image.js.map

package/dist/person/invested-company.d.ts

@@ -4,11 +4,15 @@ declare const PersonInvestedCompanySchemaDefinition: z.ZodObject<{
         defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         id: z.ZodUUID;
-        image: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        image: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
         lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         nameAlias: z.ZodArray<z.ZodType<{
             displayable?: boolean | null | undefined;

package/dist/person/investment.d.ts

@@ -81,11 +81,15 @@ declare const PersonInvestmentSchemaDefinition: z.ZodObject<{
         amountRaised: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         dateAnnounced: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         id: z.ZodUUID;
-        image: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        image: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
         investorCount: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         nameBrand: z.ZodString;
         round: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/person/person.d.ts

@@ -3,10 +3,13 @@ declare const PersonSchemaDefinition: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     gender: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     id: z.ZodUUID;
-    image: z.ZodObject<{
-        isMonogram: z.ZodBoolean;
-        picture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>;
+    image: z.ZodType<{
+        isMonogram: boolean;
+        picture?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        isMonogram: boolean;
+        picture?: string | null | undefined;
+    }, unknown>>;
     lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     nameAlias: z.ZodArray<z.ZodType<{
         displayable?: boolean | null | undefined;
@@ -42,7 +45,9 @@ declare const PersonSchemaDefinition: z.ZodObject<{
             newsArticle: "newsArticle";
             person: "person";
             product: "product";
+            researchSnippet: "researchSnippet";
             service: "service";
+            sourceDocument: "sourceDocument";
             text: "text";
         }>, z.ZodString]>;
     }, z.core.$strip>>>;

package/dist/person/similarity-result.d.ts

@@ -52,11 +52,15 @@ declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
             updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         }, z.core.$strip>>;
         entityId: z.ZodUUID;
-        entityLogo: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            logoSquare: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        entityLogo: z.ZodType<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            logo?: string | null | undefined;
+            logoSquare?: string | null | undefined;
+        }, unknown>>;
         entityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         entityOperatingStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         entitySlug: z.ZodString;
@@ -156,10 +160,13 @@ declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
             updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         }, z.core.$strip>>;
         personId: z.ZodUUID;
-        personImage: z.ZodObject<{
-            isMonogram: z.ZodBoolean;
-            picture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        personImage: z.ZodType<{
+            isMonogram: boolean;
+            picture?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            isMonogram: boolean;
+            picture?: string | null | undefined;
+        }, unknown>>;
         personName: z.ZodString;
         personSlug: z.ZodString;
         personUrlLink: z.ZodArray<z.ZodType<{

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

@@ -0,0 +1,27 @@
+import { z } from "zod/v4";
+declare const SearchAnswerCitationSchemaDefinition: z.ZodObject<{
+    entityId: z.ZodUUID;
+    source: z.ZodEnum<{
+        entityRecord: "entityRecord";
+        newsArticle: "newsArticle";
+        researchSnippet: "researchSnippet";
+    }>;
+    sourceId: z.ZodString;
+}, z.core.$strip>;
+type SearchAnswerCitationDefinition = z.infer<typeof SearchAnswerCitationSchemaDefinition>;
+/**
+ * One piece of evidence an answer cites, by its owning record.
+ *
+ * @openapiSchema SearchAnswerCitation
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerSchema
+ * @contractShape search.answer-citation
+ * @contractRole canonical
+ */
+export declare const SearchAnswerCitationSchema: z.ZodType<SearchAnswerCitationDefinition>;
+export type SearchAnswerCitation = z.infer<typeof SearchAnswerCitationSchema>;
+export {};
+//# sourceMappingURL=answer-citation.d.ts.map

package/dist/search/answer-citation.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 { SearchEvidenceSourceSchema } from "./evidence-source.js";
+const SearchAnswerCitationSchemaDefinition = z.object({
+    /** Entity the evidence is about. */
+    entityId: z.uuid(),
+    /** Record that owns the cited evidence. */
+    source: SearchEvidenceSourceSchema,
+    /** Entity id for `entityRecord`, else the snippet or news article id from `passage`. */
+    sourceId: z.string(),
+});
+/**
+ * One piece of evidence an answer cites, by its owning record.
+ *
+ * @openapiSchema SearchAnswerCitation
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerSchema
+ * @contractShape search.answer-citation
+ * @contractRole canonical
+ */
+export const SearchAnswerCitationSchema = SearchAnswerCitationSchemaDefinition;
+//# sourceMappingURL=answer-citation.js.map

package/dist/search/answer.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod/v4";
+/**
+ * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no citation means the evidence does not answer the question.
+ *
+ * @openapiSchema SearchAnswer
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema NaturalSearchResultSchema
+ * @contractShape search.answer
+ * @contractRole canonical
+ */
+export declare const SearchAnswerSchema: z.ZodObject<{
+    citation: z.ZodArray<z.ZodType<{
+        entityId: string;
+        source: "entityRecord" | "newsArticle" | "researchSnippet";
+        sourceId: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        entityId: string;
+        source: "entityRecord" | "newsArticle" | "researchSnippet";
+        sourceId: string;
+    }, unknown>>>;
+    confidence: z.ZodEnum<{
+        HIGH: "HIGH";
+        LOW: "LOW";
+        MEDIUM: "MEDIUM";
+    }>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type SearchAnswer = z.infer<typeof SearchAnswerSchema>;
+//# sourceMappingURL=answer.d.ts.map

package/dist/search/answer.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 { ConfidenceSchema } from "../confidence/confidence.js";
+import { SearchAnswerCitationSchema } from "./answer-citation.js";
+/**
+ * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no citation means the evidence does not answer the question.
+ *
+ * @openapiSchema SearchAnswer
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema NaturalSearchResultSchema
+ * @contractShape search.answer
+ * @contractRole canonical
+ */
+export const SearchAnswerSchema = z.object({
+    /** Evidence each claim rests on, in first-use order. */
+    citation: z.array(SearchAnswerCitationSchema),
+    /** How fully the cited evidence answers the question. */
+    confidence: ConfidenceSchema,
+    /** Answer text in plain prose. */
+    text: z.string(),
+});
+//# sourceMappingURL=answer.js.map

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

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+/**
+ * Owner of search evidence: `entityRecord` is the entity's structured record, `researchSnippet` an entity research snippet, `newsArticle` a news article linked to the entity.
+ *
+ * @openapiSchema SearchEvidenceSource
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerCitationSchema
+ * @usedBySchema SearchPassageSchema
+ * @contractShape search.evidence-source
+ * @contractRole canonical
+ */
+export declare const SearchEvidenceSourceSchema: z.ZodEnum<{
+    entityRecord: "entityRecord";
+    newsArticle: "newsArticle";
+    researchSnippet: "researchSnippet";
+}>;
+export type SearchEvidenceSource = z.infer<typeof SearchEvidenceSourceSchema>;
+//# sourceMappingURL=evidence-source.d.ts.map