@aventurevc/api-schemas 0.8.335 → 0.8.337

package/dist/openapi-component-manifest.js

@@ -1318,6 +1318,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     UrlTypeAlias: { modulePath: "url/type-alias", schemaName: "UrlTypeAliasSchema" },
     ValuationType: { modulePath: "valuation/type", schemaName: "ValuationTypeSchema" },
     WebSearch: { modulePath: "web/search", schemaName: "WebSearchSchema" },
+    WebSearchCacheSource: {
+        modulePath: "web/search-cache-source",
+        schemaName: "WebSearchCacheSourceSchema",
+    },
     WebSearchProvider: { modulePath: "web/search-provider", schemaName: "WebSearchProviderSchema" },
     WebSearchRecency: { modulePath: "web/search-recency", schemaName: "WebSearchRecencySchema" },
     WriterAnalysisSection: {

package/dist/search/search.d.ts

@@ -3,6 +3,10 @@ declare const SearchSchemaDefinition: z.ZodObject<{
     allowSuspectedShellStrip: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     bypassCache: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     cacheKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    cacheSource: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        ANY: "ANY";
+        PROVIDER: "PROVIDER";
+    }>>>;
     deep: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     deferredAiOverview: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/search/search.js

@@ -1,6 +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";
 import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
+import { WebSearchCacheSourceSchema } from "../web/search-cache-source.js";
 import { WebSearchProviderSchema } from "../web/search-provider.js";
 import { WebSearchRecencySchema } from "../web/search-recency.js";
 const SearchSchemaDefinition = z.object({
@@ -10,6 +11,8 @@ const SearchSchemaDefinition = z.object({
     bypassCache: z.boolean().default(false).optional(),
     /** Stable lookup text for cache keying when generated search text varies between runs */
     cacheKey: z.string().nullish(),
+    /** Permit compatible cached results from ANY provider by default, or restrict to PROVIDER. The provider field independently selects live misses; bypassCache skips every provider's cache. document.provider identifies the serving source. */
+    cacheSource: WebSearchCacheSourceSchema.default("ANY").optional(),
     /** Deprecated alias for `provider: EXA_DEEP`; `true` with any other `provider` is refused with 400. */
     deep: z.boolean().default(false).optional(),
     /** Wait in-request for 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. An explicit `true` also reruns a stored search older than SerpAPI's one-hour cache to get a fresh token (its one-minute overview token expired and the cache would return it unchanged). Without it, no deferred overview is fetched; one an earlier fetch stored still comes back at no extra cost. 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. */

package/dist/web/search-cache-source.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * ANY reuses a compatible cached web search from any provider, checking the selected provider first. PROVIDER restricts reuse to the selected live provider. Neither option changes bypassCache, which always fetches from the live provider.
+ *
+ * @openapiSchema WebSearchCacheSource
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSchema
+ * @contractShape web.search-cache-source
+ * @contractRole canonical
+ */
+export declare const WebSearchCacheSourceSchema: z.ZodEnum<{
+    ANY: "ANY";
+    PROVIDER: "PROVIDER";
+}>;
+export type WebSearchCacheSource = z.infer<typeof WebSearchCacheSourceSchema>;
+//# sourceMappingURL=search-cache-source.d.ts.map

package/dist/web/search-cache-source.js

@@ -0,0 +1,14 @@
+// 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";
+/**
+ * ANY reuses a compatible cached web search from any provider, checking the selected provider first. PROVIDER restricts reuse to the selected live provider. Neither option changes bypassCache, which always fetches from the live provider.
+ *
+ * @openapiSchema WebSearchCacheSource
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSchema
+ * @contractShape web.search-cache-source
+ * @contractRole canonical
+ */
+export const WebSearchCacheSourceSchema = z.enum(["ANY", "PROVIDER"]);
+//# sourceMappingURL=search-cache-source.js.map

package/dist/web/search.d.ts

@@ -104,6 +104,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
+        cacheSource?: "ANY" | "PROVIDER" | undefined;
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
@@ -121,6 +122,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
+        cacheSource?: "ANY" | "PROVIDER" | undefined;
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;

package/package.json

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