@aventurevc/api-schemas 0.8.142 → 0.8.146

package/dist/openapi-component-manifest.js

@@ -847,6 +847,11 @@ 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" },
+    SearchAiOverview: { modulePath: "search/ai-overview", schemaName: "SearchAiOverviewSchema" },
+    SearchAiOverviewReference: {
+        modulePath: "search/ai-overview-reference",
+        schemaName: "SearchAiOverviewReferenceSchema",
+    },
     SearchAnswer: { modulePath: "search/answer", schemaName: "SearchAnswerSchema" },
     SearchAnswerCitation: {
         modulePath: "search/answer-citation",

package/dist/search/ai-overview-reference.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+declare const SearchAiOverviewReferenceSchemaDefinition: z.ZodObject<{
+    index: z.ZodInt;
+    snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+type SearchAiOverviewReferenceDefinition = z.infer<typeof SearchAiOverviewReferenceSchemaDefinition>;
+export interface SearchAiOverviewReferenceSchemaInput extends z.input<typeof SearchAiOverviewReferenceSchemaDefinition> {
+}
+/**
+ * One page Google's AI Overview cites
+ *
+ * @openapiSchema SearchAiOverviewReference
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchAiOverviewSchema
+ * @contractShape search.ai-overview-reference
+ * @contractRole canonical
+ */
+export declare const SearchAiOverviewReferenceSchema: z.ZodType<SearchAiOverviewReferenceDefinition, SearchAiOverviewReferenceSchemaInput>;
+export type SearchAiOverviewReference = z.infer<typeof SearchAiOverviewReferenceSchema>;
+export {};
+//# sourceMappingURL=ai-overview-reference.d.ts.map

package/dist/search/ai-overview-reference.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";
+const SearchAiOverviewReferenceSchemaDefinition = z.object({
+    /** Citation number the answer text uses as `[index]` */
+    index: z.int(),
+    snippet: z.string().nullish(),
+    /** Publisher name Google shows for the page */
+    source: z.string().nullish(),
+    title: z.string(),
+    url: z.string(),
+});
+/**
+ * One page Google's AI Overview cites
+ *
+ * @openapiSchema SearchAiOverviewReference
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchAiOverviewSchema
+ * @contractShape search.ai-overview-reference
+ * @contractRole canonical
+ */
+export const SearchAiOverviewReferenceSchema = SearchAiOverviewReferenceSchemaDefinition;
+//# sourceMappingURL=ai-overview-reference.js.map

package/dist/search/ai-overview.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+/**
+ * Google's AI Overview for a web search: its generated answer and the pages it cites
+ *
+ * @openapiSchema SearchAiOverview
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.ai-overview
+ * @contractRole canonical
+ */
+export declare const SearchAiOverviewSchema: z.ZodObject<{
+    reference: z.ZodArray<z.ZodType<{
+        index: number;
+        snippet?: string | null | undefined;
+        source?: string | null | undefined;
+        title: string;
+        url: string;
+    }, import("./ai-overview-reference.ts").SearchAiOverviewReferenceSchemaInput, z.core.$ZodTypeInternals<{
+        index: number;
+        snippet?: string | null | undefined;
+        source?: string | null | undefined;
+        title: string;
+        url: string;
+    }, import("./ai-overview-reference.ts").SearchAiOverviewReferenceSchemaInput>>>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type SearchAiOverview = z.infer<typeof SearchAiOverviewSchema>;
+//# sourceMappingURL=ai-overview.d.ts.map

package/dist/search/ai-overview.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";
+import { SearchAiOverviewReferenceSchema } from "./ai-overview-reference.js";
+/**
+ * Google's AI Overview for a web search: its generated answer and the pages it cites
+ *
+ * @openapiSchema SearchAiOverview
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.ai-overview
+ * @contractRole canonical
+ */
+export const SearchAiOverviewSchema = z.object({
+    /** Pages the answer cites */
+    reference: z.array(SearchAiOverviewReferenceSchema),
+    /** Generated answer as Markdown in Google's block order; `[n]` cites the reference whose `index` is n */
+    text: z.string(),
+});
+//# sourceMappingURL=ai-overview.js.map

package/dist/search/search.d.ts

@@ -5,6 +5,7 @@ declare const SearchSchemaDefinition: z.ZodObject<{
     cacheKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     catalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     deep: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    deferredAiOverview: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     resultLimit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;

package/dist/search/search.js

@@ -13,6 +13,8 @@ const SearchSchemaDefinition = z.object({
     catalogRevision: z.int().nullish(),
     /** Run Exa's slower, broader deep search instead of the default provider: higher recall for market and provider questions, about 3-6 s per search, answered synchronously (`Prefer: respond-async` does not apply). Charged like any search. */
     deep: z.boolean().default(false).optional(),
+    /** Also fetch Google's AI Overview when Google defers it to a follow-up request, as it does for most company and person lookups: one extra SerpAPI search per overview not already stored, plus a fresh search first when the stored search is over an hour old (its one-minute overview token expired and SerpAPI's cache would return it unchanged). A fetch that returns no overview is not retried for six hours. An overview Google returns inline always comes back in `aiOverview` at no extra cost. Exa results never carry one. */
+    deferredAiOverview: z.boolean().default(false).optional(),
     /** Search language code */
     language: z.string().nullish(),
     /** Search region code */

package/dist/web/search.d.ts

@@ -1,5 +1,21 @@
 import { z } from "zod/v4";
 declare const WebSearchSchemaDefinition: z.ZodObject<{
+    aiOverview: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        reference: z.ZodArray<z.ZodType<{
+            index: number;
+            snippet?: string | null | undefined;
+            source?: string | null | undefined;
+            title: string;
+            url: string;
+        }, import("../search/ai-overview-reference.ts").SearchAiOverviewReferenceSchemaInput, z.core.$ZodTypeInternals<{
+            index: number;
+            snippet?: string | null | undefined;
+            source?: string | null | undefined;
+            title: string;
+            url: string;
+        }, import("../search/ai-overview-reference.ts").SearchAiOverviewReferenceSchemaInput>>>;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
     document: z.ZodType<{
         cacheHitCount: number;
         createdAt: string;
@@ -48,6 +64,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         cacheKey?: string | null | undefined;
         catalogRevision?: number | null | undefined;
         deep?: boolean | undefined;
+        deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;
@@ -65,6 +82,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         cacheKey?: string | null | undefined;
         catalogRevision?: number | null | undefined;
         deep?: boolean | undefined;
+        deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;

package/dist/web/search.js

@@ -1,9 +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";
+import { SearchAiOverviewSchema } from "../search/ai-overview.js";
 import { SearchHitSchema } from "../search/hit.js";
 import { SearchSchema } from "../search/search.js";
 import { SourceDocumentListSchema } from "../source/document-list.js";
 const WebSearchSchemaDefinition = z.object({
+    /** Google's AI Overview: returned whenever Google answers inline, or fetched on request with `deferredAiOverview`; null when Google produced none or deferred it unrequested */
+    aiOverview: SearchAiOverviewSchema.nullish(),
     /** Source-document ledger row backing this result */
     document: SourceDocumentListSchema,
     /** Normalized result items in provider rank order */

package/package.json

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