@aventurevc/api-schemas 0.8.61 → 0.8.63

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

@@ -178,7 +178,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
                 sourceId: string;
                 sourceJson: string;
                 sourceText: string;
-                sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
+                sourceType: string;
             } | null | undefined;
             slug: string;
             suffix?: string | null | undefined;
@@ -224,7 +224,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
                 sourceId: string;
                 sourceJson: string;
                 sourceText: string;
-                sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
+                sourceType: string;
             } | null | undefined;
             slug: string;
             suffix?: string | null | undefined;

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;
@@ -33,7 +36,7 @@ declare const PersonSchemaDefinition: z.ZodObject<{
         sourceId: z.ZodString;
         sourceJson: z.ZodString;
         sourceText: z.ZodString;
-        sourceType: z.ZodEnum<{
+        sourceType: z.ZodUnion<readonly [z.ZodEnum<{
             agentHelpDoc: "agentHelpDoc";
             blogPost: "blogPost";
             classificationCode: "classificationCode";
@@ -42,9 +45,11 @@ declare const PersonSchemaDefinition: z.ZodObject<{
             newsArticle: "newsArticle";
             person: "person";
             product: "product";
+            researchSnippet: "researchSnippet";
             service: "service";
+            sourceDocument: "sourceDocument";
             text: "text";
-        }>;
+        }>, z.ZodString]>;
     }, z.core.$strip>>>;
     slug: z.ZodString;
     suffix: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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<{
@@ -234,7 +241,7 @@ declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
             sourceId: string;
             sourceJson: string;
             sourceText: string;
-            sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
+            sourceType: string;
         } | null | undefined;
         slug: string;
         suffix?: string | null | undefined;
@@ -274,7 +281,7 @@ declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
             sourceId: string;
             sourceJson: string;
             sourceText: string;
-            sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
+            sourceType: string;
         } | null | undefined;
         slug: string;
         suffix?: string | null | undefined;

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

package/dist/search/evidence-source.js

@@ -0,0 +1,21 @@
+// 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";
+/**
+ * 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 const SearchEvidenceSourceSchema = z.enum([
+    "entityRecord",
+    "researchSnippet",
+    "newsArticle",
+]);
+//# sourceMappingURL=evidence-source.js.map

package/dist/search/intent.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+/**
+ * Question shape the planner read from a natural-language search. `discovery` lists entities matching a description; `profile` asks what a named entity does, offers, or how it stands; `peer` asks for a named entity's competitors or look-alikes; `comparison` asks how two or more named entities compare.
+ *
+ * @openapiSchema SearchIntent
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchInterpretationSchema
+ * @contractShape search.intent
+ * @contractRole canonical
+ */
+export declare const SearchIntentSchema: z.ZodEnum<{
+    comparison: "comparison";
+    discovery: "discovery";
+    peer: "peer";
+    profile: "profile";
+}>;
+export type SearchIntent = z.infer<typeof SearchIntentSchema>;
+//# sourceMappingURL=intent.d.ts.map

package/dist/search/intent.js

@@ -0,0 +1,16 @@
+// 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";
+/**
+ * Question shape the planner read from a natural-language search. `discovery` lists entities matching a description; `profile` asks what a named entity does, offers, or how it stands; `peer` asks for a named entity's competitors or look-alikes; `comparison` asks how two or more named entities compare.
+ *
+ * @openapiSchema SearchIntent
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchInterpretationSchema
+ * @contractShape search.intent
+ * @contractRole canonical
+ */
+export const SearchIntentSchema = z.enum(["discovery", "profile", "peer", "comparison"]);
+//# sourceMappingURL=intent.js.map

package/dist/search/interpretation.d.ts

@@ -210,6 +210,12 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
             min?: number | null | undefined;
         }[] | undefined;
     }, unknown>>;
+    intent: z.ZodEnum<{
+        comparison: "comparison";
+        discovery: "discovery";
+        peer: "peer";
+        profile: "profile";
+    }>;
     interpretation: z.ZodString;
     sort: z.ZodType<{
         order: {
@@ -224,6 +230,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
         }[];
         relevance?: "keyword" | "semantic" | null | undefined;
     }, unknown>>;
+    subjectEntityName: z.ZodArray<z.ZodString>;
     unsupported: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type SearchInterpretationDefinition = z.infer<typeof SearchInterpretationSchemaDefinition>;

package/dist/search/interpretation.js

@@ -2,6 +2,7 @@
 import { z } from "zod/v4";
 import { ConfidenceSchema } from "../confidence/confidence.js";
 import { EntityListFilterSchema } from "../entity/list-filter.js";
+import { SearchIntentSchema } from "./intent.js";
 import { SearchModeExecutionSchema } from "./mode-execution.js";
 import { SearchOrderingEntityFilterSortableSchema } from "./ordering-entity-filter-sortable.js";
 const SearchInterpretationSchemaDefinition = z.object({
@@ -13,10 +14,14 @@ const SearchInterpretationSchemaDefinition = z.object({
     fallbackUsed: z.boolean(),
     /** Canonical entity filter generated from the natural-language query. */
     filter: EntityListFilterSchema,
+    /** Question shape the planner read from the query. */
+    intent: SearchIntentSchema,
     /** 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,
+    /** Brand or legal names of the entities the question is about, as written in the query; empty for discovery questions. */
+    subjectEntityName: z.array(z.string()),
     /** Constraint the planner could not translate into the canonical EntityFilter contract; null when every material constraint was supported. */
     unsupported: z.string().nullish(),
 });

package/dist/search/layer.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod/v4";
+/**
+ * Optional answer layer for a natural-language entity search. `passage` adds the text passages, from public research snippets and linked news, that best answer the question about the subject entities, their peers, or the top results; `synthesis` adds a written answer grounded only in those records and passages, citing each, and implies `passage`.
+ *
+ * @openapiSchema SearchLayer
+ * @endpoint POST /v1/search/natural/entities
+ * @contractShape search.layer
+ * @contractRole canonical
+ */
+export declare const SearchLayerSchema: z.ZodEnum<{
+    passage: "passage";
+    synthesis: "synthesis";
+}>;
+export type SearchLayer = z.infer<typeof SearchLayerSchema>;
+//# sourceMappingURL=layer.d.ts.map

package/dist/search/layer.js

@@ -0,0 +1,12 @@
+// 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";
+/**
+ * Optional answer layer for a natural-language entity search. `passage` adds the text passages, from public research snippets and linked news, that best answer the question about the subject entities, their peers, or the top results; `synthesis` adds a written answer grounded only in those records and passages, citing each, and implies `passage`.
+ *
+ * @openapiSchema SearchLayer
+ * @endpoint POST /v1/search/natural/entities
+ * @contractShape search.layer
+ * @contractRole canonical
+ */
+export const SearchLayerSchema = z.enum(["passage", "synthesis"]);
+//# sourceMappingURL=layer.js.map

package/dist/search/mode.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner. Entity and person natural-search support every mode; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.
+ * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner. Entity and person natural-search support every mode; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword` (the full text of articles, posts, and fetched pages), and `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies).
  *
  * @openapiSchema SearchMode
  * @endpoint GET /v1/search/link

package/dist/search/mode.js

@@ -1,7 +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";
 /**
- * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner. Entity and person natural-search support every mode; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.
+ * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner. Entity and person natural-search support every mode; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword` (the full text of articles, posts, and fetched pages), and `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies).
  *
  * @openapiSchema SearchMode
  * @endpoint GET /v1/search/link

package/dist/search/passage.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod/v4";
+declare const SearchPassageSchemaDefinition: z.ZodObject<{
+    entityId: z.ZodUUID;
+    label: z.ZodString;
+    publishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    score: z.ZodNumber;
+    source: z.ZodEnum<{
+        entityRecord: "entityRecord";
+        newsArticle: "newsArticle";
+        researchSnippet: "researchSnippet";
+    }>;
+    sourceId: z.ZodString;
+    text: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type SearchPassageDefinition = z.infer<typeof SearchPassageSchemaDefinition>;
+/**
+ * Text passage ranked by semantic closeness to a natural-language question, read from its owning record.
+ *
+ * @openapiSchema SearchPassage
+ * @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.passage
+ * @contractRole canonical
+ */
+export declare const SearchPassageSchema: z.ZodType<SearchPassageDefinition>;
+export type SearchPassage = z.infer<typeof SearchPassageSchema>;
+export {};
+//# sourceMappingURL=passage.d.ts.map

package/dist/search/passage.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 { SearchEvidenceSourceSchema } from "./evidence-source.js";
+const SearchPassageSchemaDefinition = z.object({
+    /** Entity the passage is about. */
+    entityId: z.uuid(),
+    /** Snippet type key for research snippets, or the article title for news articles. */
+    label: z.string(),
+    /** Article publication time for news passages; null for snippets. */
+    publishedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Cosine similarity between the question and the passage; higher is closer. Compare scores only within one response. */
+    score: z.number(),
+    /** Record type that owns the passage text. */
+    source: SearchEvidenceSourceSchema,
+    /** Identifier of the owning snippet or news article. */
+    sourceId: z.string(),
+    /** Passage text: the snippet, or the article summary or excerpt. */
+    text: z.string(),
+    /** Original article URL for news passages; null for snippets. */
+    url: z.string().nullish(),
+});
+/**
+ * Text passage ranked by semantic closeness to a natural-language question, read from its owning record.
+ *
+ * @openapiSchema SearchPassage
+ * @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.passage
+ * @contractRole canonical
+ */
+export const SearchPassageSchema = SearchPassageSchemaDefinition;
+//# sourceMappingURL=passage.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.8.61",
+  "version": "0.8.63",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",