@aventurevc/api-schemas 0.8.158 → 0.8.159

package/dist/openapi-component-manifest.js

@@ -875,6 +875,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "SearchAiOverviewReferenceSchema",
     },
     SearchAnswer: { modulePath: "search/answer", schemaName: "SearchAnswerSchema" },
+    SearchAnswerBox: { modulePath: "search/answer-box", schemaName: "SearchAnswerBoxSchema" },
     SearchAnswerCitation: {
         modulePath: "search/answer-citation",
         schemaName: "SearchAnswerCitationSchema",
@@ -900,6 +901,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     },
     SearchInvestment: { modulePath: "search/investment", schemaName: "SearchInvestmentSchema" },
     SearchJudgment: { modulePath: "search/judgment", schemaName: "SearchJudgmentSchema" },
+    SearchKnowledgeGraph: {
+        modulePath: "search/knowledge-graph",
+        schemaName: "SearchKnowledgeGraphSchema",
+    },
     SearchLayer: { modulePath: "search/layer", schemaName: "SearchLayerSchema" },
     SearchMode: { modulePath: "search/mode", schemaName: "SearchModeSchema" },
     SearchModeExecution: {
@@ -920,7 +925,16 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "search/qualifier-option",
         schemaName: "SearchQualifierOptionSchema",
     },
+    SearchRelatedQuestion: {
+        modulePath: "search/related-question",
+        schemaName: "SearchRelatedQuestionSchema",
+    },
     SearchRelevance: { modulePath: "search/relevance", schemaName: "SearchRelevanceSchema" },
+    SearchSportsResult: {
+        modulePath: "search/sports-result",
+        schemaName: "SearchSportsResultSchema",
+    },
+    SearchSportsTeam: { modulePath: "search/sports-team", schemaName: "SearchSportsTeamSchema" },
     SecCompany: { modulePath: "sec/company", schemaName: "SecCompanySchema" },
     SecListingProspectus: {
         modulePath: "sec/listing-prospectus",

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

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+/**
+ * Google's direct answer shown above the results
+ *
+ * @openapiSchema SearchAnswerBox
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.answer-box
+ * @contractRole canonical
+ */
+export declare const SearchAnswerBoxSchema: z.ZodObject<{
+    answer: z.ZodString;
+    snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SearchAnswerBox = z.infer<typeof SearchAnswerBoxSchema>;
+//# sourceMappingURL=answer-box.d.ts.map

package/dist/search/answer-box.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";
+/**
+ * Google's direct answer shown above the results
+ *
+ * @openapiSchema SearchAnswerBox
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.answer-box
+ * @contractRole canonical
+ */
+export const SearchAnswerBoxSchema = z.object({
+    /** Direct answer text; Google's snippet when the box states no separate answer */
+    answer: z.string(),
+    /** Supporting snippet the box shows */
+    snippet: z.string().nullish(),
+    /** Title of the page the answer comes from */
+    title: z.string().nullish(),
+    /** Google's answer-box kind */
+    type: z.string().nullish(),
+    /** URL of the page the answer comes from */
+    url: z.string().nullish(),
+});
+//# sourceMappingURL=answer-box.js.map

package/dist/search/knowledge-graph.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+/**
+ * Google's knowledge panel for the entity the query names
+ *
+ * @openapiSchema SearchKnowledgeGraph
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.knowledge-graph
+ * @contractRole canonical
+ */
+export declare const SearchKnowledgeGraphSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    website: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SearchKnowledgeGraph = z.infer<typeof SearchKnowledgeGraphSchema>;
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/search/knowledge-graph.js

@@ -0,0 +1,23 @@
+// 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";
+/**
+ * Google's knowledge panel for the entity the query names
+ *
+ * @openapiSchema SearchKnowledgeGraph
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.knowledge-graph
+ * @contractRole canonical
+ */
+export const SearchKnowledgeGraphSchema = z.object({
+    /** Entity description the panel shows */
+    description: z.string().nullish(),
+    /** Entity name the panel shows */
+    title: z.string().nullish(),
+    /** Entity kind Google states */
+    type: z.string().nullish(),
+    /** Official website the panel links */
+    website: z.string().nullish(),
+});
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/search/related-question.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+declare const SearchRelatedQuestionSchemaDefinition: z.ZodObject<{
+    question: z.ZodString;
+    snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type SearchRelatedQuestionDefinition = z.infer<typeof SearchRelatedQuestionSchemaDefinition>;
+export interface SearchRelatedQuestionSchemaInput extends z.input<typeof SearchRelatedQuestionSchemaDefinition> {
+}
+/**
+ * One "People also ask" question Google shows for the query
+ *
+ * @openapiSchema SearchRelatedQuestion
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.related-question
+ * @contractRole canonical
+ */
+export declare const SearchRelatedQuestionSchema: z.ZodType<SearchRelatedQuestionDefinition, SearchRelatedQuestionSchemaInput>;
+export type SearchRelatedQuestion = z.infer<typeof SearchRelatedQuestionSchema>;
+export {};
+//# sourceMappingURL=related-question.d.ts.map

package/dist/search/related-question.js

@@ -0,0 +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";
+const SearchRelatedQuestionSchemaDefinition = z.object({
+    /** Question text */
+    question: z.string(),
+    /** Answer snippet; null when Google answers the question with an AI Overview */
+    snippet: z.string().nullish(),
+    /** Title of the page the snippet comes from */
+    title: z.string().nullish(),
+    /** URL of the page the snippet comes from */
+    url: z.string().nullish(),
+});
+/**
+ * One "People also ask" question Google shows for the query
+ *
+ * @openapiSchema SearchRelatedQuestion
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.related-question
+ * @contractRole canonical
+ */
+export const SearchRelatedQuestionSchema = SearchRelatedQuestionSchemaDefinition;
+//# sourceMappingURL=related-question.js.map

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

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+/**
+ * Google's spotlight for one game the query names
+ *
+ * @openapiSchema SearchSportsResult
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.sports-result
+ * @contractRole canonical
+ */
+export declare const SearchSportsResultSchema: z.ZodObject<{
+    date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    league: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    team: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        name: string;
+        seeding?: number | null | undefined;
+    }, import("./sports-team.ts").SearchSportsTeamSchemaInput, z.core.$ZodTypeInternals<{
+        name: string;
+        seeding?: number | null | undefined;
+    }, import("./sports-team.ts").SearchSportsTeamSchemaInput>>>>>;
+    venue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SearchSportsResult = z.infer<typeof SearchSportsResultSchema>;
+//# sourceMappingURL=sports-result.d.ts.map

package/dist/search/sports-result.js

@@ -0,0 +1,26 @@
+// 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 { SearchSportsTeamSchema } from "./sports-team.js";
+/**
+ * Google's spotlight for one game the query names
+ *
+ * @openapiSchema SearchSportsResult
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.sports-result
+ * @contractRole canonical
+ */
+export const SearchSportsResultSchema = z.object({
+    /** Game date as Google states it */
+    date: z.string().nullish(),
+    /** League or tournament */
+    league: z.string().nullish(),
+    /** Stage of the competition */
+    stage: z.string().nullish(),
+    /** Teams in the game */
+    team: z.array(SearchSportsTeamSchema).nullish(),
+    /** Venue or stadium */
+    venue: z.string().nullish(),
+});
+//# sourceMappingURL=sports-result.js.map

package/dist/search/sports-team.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const SearchSportsTeamSchemaDefinition: z.ZodObject<{
+    name: z.ZodString;
+    seeding: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+}, z.core.$strip>;
+type SearchSportsTeamDefinition = z.infer<typeof SearchSportsTeamSchemaDefinition>;
+export interface SearchSportsTeamSchemaInput extends z.input<typeof SearchSportsTeamSchemaDefinition> {
+}
+/**
+ * One team in a spotlighted game
+ *
+ * @openapiSchema SearchSportsTeam
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSportsResultSchema
+ * @contractShape search.sports-team
+ * @contractRole canonical
+ */
+export declare const SearchSportsTeamSchema: z.ZodType<SearchSportsTeamDefinition, SearchSportsTeamSchemaInput>;
+export type SearchSportsTeam = z.infer<typeof SearchSportsTeamSchema>;
+export {};
+//# sourceMappingURL=sports-team.d.ts.map

package/dist/search/sports-team.js

@@ -0,0 +1,20 @@
+// 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 SearchSportsTeamSchemaDefinition = z.object({
+    /** Team name */
+    name: z.string(),
+    /** Tournament seeding when Google states one */
+    seeding: z.int().nullish(),
+});
+/**
+ * One team in a spotlighted game
+ *
+ * @openapiSchema SearchSportsTeam
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSportsResultSchema
+ * @contractShape search.sports-team
+ * @contractRole canonical
+ */
+export const SearchSportsTeamSchema = SearchSportsTeamSchemaDefinition;
+//# sourceMappingURL=sports-team.js.map

package/dist/web/search.d.ts

@@ -16,6 +16,13 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         }, import("../search/ai-overview-reference.ts").SearchAiOverviewReferenceSchemaInput>>>;
         text: z.ZodString;
     }, z.core.$strip>>>;
+    answerBox: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        answer: z.ZodString;
+        snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
     document: z.ZodType<{
         cacheHitCount: number;
         createdAt: string;
@@ -47,6 +54,24 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         sourceKey: string;
         upstreamContentEncoding?: string | null | undefined;
     }, import("../source/document-list.ts").SourceDocumentListSchemaInput>>;
+    knowledgeGraph: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        website: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    relatedQuestion: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        question: string;
+        snippet?: string | null | undefined;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+    }, import("../search/related-question.ts").SearchRelatedQuestionSchemaInput, z.core.$ZodTypeInternals<{
+        question: string;
+        snippet?: string | null | undefined;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+    }, import("../search/related-question.ts").SearchRelatedQuestionSchemaInput>>>>>;
+    relatedSearch: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     result: z.ZodArray<z.ZodType<{
         relevanceScore: number;
         snippet: string;
@@ -97,6 +122,19 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         tenant?: "development" | "production" | "staging" | "unassigned" | null | undefined;
         tenantPolicyRevision?: number | null | undefined;
     }, import("../search/search.ts").SearchSchemaInput>>;
+    sportsResult: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        league: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        stage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        team: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+            name: string;
+            seeding?: number | null | undefined;
+        }, import("../search/sports-team.ts").SearchSportsTeamSchemaInput, z.core.$ZodTypeInternals<{
+            name: string;
+            seeding?: number | null | undefined;
+        }, import("../search/sports-team.ts").SearchSportsTeamSchemaInput>>>>>;
+        venue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type WebSearchDefinition = z.infer<typeof WebSearchSchemaDefinition>;
 export interface WebSearchSchemaInput extends z.input<typeof WebSearchSchemaDefinition> {

package/dist/web/search.js

@@ -1,18 +1,32 @@
 // 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 { SearchAiOverviewSchema } from "../search/ai-overview.js";
+import { SearchAnswerBoxSchema } from "../search/answer-box.js";
 import { SearchHitSchema } from "../search/hit.js";
+import { SearchKnowledgeGraphSchema } from "../search/knowledge-graph.js";
+import { SearchRelatedQuestionSchema } from "../search/related-question.js";
 import { SearchSchema } from "../search/search.js";
+import { SearchSportsResultSchema } from "../search/sports-result.js";
 import { SourceDocumentListSchema } from "../source/document-list.js";
 const WebSearchSchemaDefinition = z.object({
     /** Google's AI Overview: returned whenever Google answers inline or its deferred overview is stored (fetched by this or an earlier search that set `deferredAiOverview`); null when Google produced none or no such fetch stored its deferred overview */
     aiOverview: SearchAiOverviewSchema.nullish(),
+    /** Google's direct answer box; null when the page shows none */
+    answerBox: SearchAnswerBoxSchema.nullish(),
     /** Source-document ledger row backing this result */
     document: SourceDocumentListSchema,
+    /** Google's knowledge panel; null when the page shows none */
+    knowledgeGraph: SearchKnowledgeGraphSchema.nullish(),
+    /** Google's "People also ask" questions; null when the page shows none */
+    relatedQuestion: z.array(SearchRelatedQuestionSchema).nullish(),
+    /** Google's related searches; null when the page shows none */
+    relatedSearch: z.array(z.string()).nullish(),
     /** Normalized result items in provider rank order */
     result: z.array(SearchHitSchema),
     /** Web search request represented by this result */
     search: SearchSchema,
+    /** Google's game spotlight; null when the page shows none */
+    sportsResult: SearchSportsResultSchema.nullish(),
 });
 /**
  * Live web search result with its backing source-document row and normalized items

package/package.json

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