@aventurevc/api-schemas 0.8.69 → 0.8.70

package/dist/federated/search.d.ts

@@ -8,6 +8,16 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 sourceId: string;
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
+            paragraph: {
+                citation: {
+                    entityId: string;
+                    source: "entityRecord" | "newsArticle" | "researchSnippet";
+                    sourceId: string;
+                }[];
+                text: string;
+                topic?: string | null | undefined;
+            }[];
+            relatedQuery: string[];
             text: string;
         } | null | undefined;
         interpretation: {
@@ -2071,6 +2081,16 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 sourceId: string;
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
+            paragraph: {
+                citation: {
+                    entityId: string;
+                    source: "entityRecord" | "newsArticle" | "researchSnippet";
+                    sourceId: string;
+                }[];
+                text: string;
+                topic?: string | null | undefined;
+            }[];
+            relatedQuery: string[];
             text: string;
         } | null | undefined;
         interpretation: {

package/dist/help/resolution.js

@@ -19,7 +19,7 @@ export const HelpResolutionSchema = z.object({
     operationId: z.string().nullish(),
     /** Which of the mutually exclusive resolve outcomes was reached. */
     outcome: HelpResolutionOutcomeSchema,
-    /** Probability the decision model gave the chosen option (an operation, or none). */
+    /** Probability the decision model gave its chosen option (an operation, a task, several, or none); informational, the choice alone decides the outcome. */
     probability: z.number().nullish(),
     /** The chosen catalog task for TASK_PLAN, or the task leading a CLARIFY; getHarnessTaskPlan reads its plan. */
     taskKey: z.string().nullish(),

package/dist/link/search.d.ts

@@ -10,6 +10,16 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     sourceId: string;
                 }[];
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                paragraph: {
+                    citation: {
+                        entityId: string;
+                        source: "entityRecord" | "newsArticle" | "researchSnippet";
+                        sourceId: string;
+                    }[];
+                    text: string;
+                    topic?: string | null | undefined;
+                }[];
+                relatedQuery: string[];
                 text: string;
             } | null | undefined;
             interpretation: {
@@ -2233,6 +2243,16 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     sourceId: string;
                 }[];
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                paragraph: {
+                    citation: {
+                        entityId: string;
+                        source: "entityRecord" | "newsArticle" | "researchSnippet";
+                        sourceId: string;
+                    }[];
+                    text: string;
+                    topic?: string | null | undefined;
+                }[];
+                relatedQuery: string[];
                 text: string;
             } | null | undefined;
             interpretation: {

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

@@ -15,6 +15,24 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             LOW: "LOW";
             MEDIUM: "MEDIUM";
         }>;
+        paragraph: z.ZodArray<z.ZodType<{
+            citation: {
+                entityId: string;
+                source: "entityRecord" | "newsArticle" | "researchSnippet";
+                sourceId: string;
+            }[];
+            text: string;
+            topic?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            citation: {
+                entityId: string;
+                source: "entityRecord" | "newsArticle" | "researchSnippet";
+                sourceId: string;
+            }[];
+            text: string;
+            topic?: string | null | undefined;
+        }, unknown>>>;
+        relatedQuery: z.ZodArray<z.ZodString>;
         text: z.ZodString;
     }, z.core.$strip>>>;
     interpretation: z.ZodType<{

package/dist/openapi-component-manifest.js

@@ -799,6 +799,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "search/answer-citation",
         schemaName: "SearchAnswerCitationSchema",
     },
+    SearchAnswerParagraph: {
+        modulePath: "search/answer-paragraph",
+        schemaName: "SearchAnswerParagraphSchema",
+    },
     SearchDuplicateCandidateScore: {
         modulePath: "search/duplicate-candidate-score",
         schemaName: "SearchDuplicateCandidateScoreSchema",

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

@@ -17,6 +17,7 @@ type SearchAnswerCitationDefinition = z.infer<typeof SearchAnswerCitationSchemaD
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerParagraphSchema
  * @usedBySchema SearchAnswerSchema
  * @contractShape search.answer-citation
  * @contractRole canonical

package/dist/search/answer-citation.js

@@ -17,6 +17,7 @@ const SearchAnswerCitationSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerParagraphSchema
  * @usedBySchema SearchAnswerSchema
  * @contractShape search.answer-citation
  * @contractRole canonical

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

@@ -0,0 +1,31 @@
+import { z } from "zod/v4";
+declare const SearchAnswerParagraphSchemaDefinition: 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>>>;
+    text: z.ZodString;
+    topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type SearchAnswerParagraphDefinition = z.infer<typeof SearchAnswerParagraphSchemaDefinition>;
+/**
+ * One paragraph of an answer and the evidence it rests on.
+ *
+ * @openapiSchema SearchAnswerParagraph
+ * @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-paragraph
+ * @contractRole canonical
+ */
+export declare const SearchAnswerParagraphSchema: z.ZodType<SearchAnswerParagraphDefinition>;
+export type SearchAnswerParagraph = z.infer<typeof SearchAnswerParagraphSchema>;
+export {};
+//# sourceMappingURL=answer-paragraph.d.ts.map

package/dist/search/answer-paragraph.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 { SearchAnswerCitationSchema } from "./answer-citation.js";
+const SearchAnswerParagraphSchemaDefinition = z.object({
+    /** Evidence this paragraph rests on, most important first. */
+    citation: z.array(SearchAnswerCitationSchema),
+    /** Paragraph text in plain prose. */
+    text: z.string(),
+    /** Short label naming the category, market, or segment this paragraph covers, such as "Smartphones · North America"; absent on the lead paragraph. */
+    topic: z.string().nullish(),
+});
+/**
+ * One paragraph of an answer and the evidence it rests on.
+ *
+ * @openapiSchema SearchAnswerParagraph
+ * @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-paragraph
+ * @contractRole canonical
+ */
+export const SearchAnswerParagraphSchema = SearchAnswerParagraphSchemaDefinition;
+//# sourceMappingURL=answer-paragraph.js.map

package/dist/search/answer.d.ts

@@ -1,6 +1,6 @@
 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.
+ * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no paragraph means the evidence does not answer the question.
  *
  * @openapiSchema SearchAnswer
  * @endpoint GET /v1/search/link
@@ -26,6 +26,24 @@ export declare const SearchAnswerSchema: z.ZodObject<{
         LOW: "LOW";
         MEDIUM: "MEDIUM";
     }>;
+    paragraph: z.ZodArray<z.ZodType<{
+        citation: {
+            entityId: string;
+            source: "entityRecord" | "newsArticle" | "researchSnippet";
+            sourceId: string;
+        }[];
+        text: string;
+        topic?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        citation: {
+            entityId: string;
+            source: "entityRecord" | "newsArticle" | "researchSnippet";
+            sourceId: string;
+        }[];
+        text: string;
+        topic?: string | null | undefined;
+    }, unknown>>>;
+    relatedQuery: z.ZodArray<z.ZodString>;
     text: z.ZodString;
 }, z.core.$strip>;
 export type SearchAnswer = z.infer<typeof SearchAnswerSchema>;

package/dist/search/answer.js

@@ -2,8 +2,9 @@
 import { z } from "zod/v4";
 import { ConfidenceSchema } from "../confidence/confidence.js";
 import { SearchAnswerCitationSchema } from "./answer-citation.js";
+import { SearchAnswerParagraphSchema } from "./answer-paragraph.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.
+ * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no paragraph means the evidence does not answer the question.
  *
  * @openapiSchema SearchAnswer
  * @endpoint GET /v1/search/link
@@ -15,11 +16,15 @@ import { SearchAnswerCitationSchema } from "./answer-citation.js";
  * @contractRole canonical
  */
 export const SearchAnswerSchema = z.object({
-    /** Evidence each claim rests on, in first-use order. */
+    /** Evidence the paragraphs cite, in first-use order. */
     citation: z.array(SearchAnswerCitationSchema),
     /** How fully the cited evidence answers the question. */
     confidence: ConfidenceSchema,
-    /** Answer text in plain prose. */
+    /** The answer's paragraphs in reading order, each citing the evidence it rests on; empty when the answer abstains. */
+    paragraph: z.array(SearchAnswerParagraphSchema),
+    /** Up to five follow-up searches grounded in the cited evidence; empty when the answer abstains. */
+    relatedQuery: z.array(z.string()),
+    /** Every paragraph's text in reading order, separated by blank lines; read `paragraph` to place each citation beside the text it supports. */
     text: z.string(),
 });
 //# sourceMappingURL=answer.js.map

package/dist/search/mode.d.ts

@@ -9,7 +9,7 @@ declare const SearchModeSchemaDefinition: z.ZodUnion<readonly [z.ZodEnum<{
 }>, z.ZodString]>;
 type SearchModeDefinition = z.infer<typeof SearchModeSchemaDefinition>;
 /**
- * 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; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused).
+ * 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; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused; each ranking is cut at the largest page size, so a hybrid search returns at most twice that many items, and it orders by fused rank only, ignoring `sort`).
  *
  * @openapiSchema SearchMode
  * @endpoint GET /v1/search/link

package/dist/search/mode.js

@@ -5,7 +5,7 @@ const SearchModeSchemaDefinition = z.union([
     z.string(),
 ]);
 /**
- * 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; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused).
+ * 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; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused; each ranking is cut at the largest page size, so a hybrid search returns at most twice that many items, and it orders by fused rank only, ignoring `sort`).
  *
  * @openapiSchema SearchMode
  * @endpoint GET /v1/search/link

package/package.json

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