@aventurevc/api-schemas 0.8.149 → 0.8.154

package/dist/billing/subscription.d.ts

@@ -156,6 +156,7 @@ declare const BillingSubscriptionSchemaDefinition: z.ZodObject<{
     }, import("../research/allowance-usage.ts").ResearchAllowanceUsageSchemaInput>>;
     cancelAtPeriodEnd: z.ZodBoolean;
     entitled: z.ZodBoolean;
+    originalStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     pendingPlan: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";

package/dist/billing/subscription.js

@@ -12,6 +12,8 @@ const BillingSubscriptionSchemaDefinition = z.object({
     cancelAtPeriodEnd: z.boolean(),
     /** True while the subscription grants its paid tier */
     entitled: z.boolean(),
+    /** Original start of the continuing paid subscription; absent when the provider did not supply it */
+    originalStart: z.iso.datetime({ offset: true }).nullish(),
     /** Plan a scheduled change moves the subscription to at pendingPlanAt; absent when nothing is scheduled */
     pendingPlan: BillingPlanTypeSchema.nullish(),
     /** When pendingPlan takes effect; absent when nothing is scheduled */

package/dist/openapi-component-manifest.js

@@ -966,5 +966,6 @@ 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" },
+    WebSearchProvider: { modulePath: "web/search-provider", schemaName: "WebSearchProviderSchema" },
 });
 //# sourceMappingURL=openapi-component-manifest.js.map

package/dist/search/search.d.ts

@@ -7,6 +7,11 @@ declare const SearchSchemaDefinition: z.ZodObject<{
     deep: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     deferredAiOverview: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        EXA: "EXA";
+        EXA_DEEP: "EXA_DEEP";
+        SERPAPI: "SERPAPI";
+    }>, z.ZodString]>>>;
     region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     resultLimit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     retrievedFor: z.ZodOptional<z.ZodNullable<z.ZodObject<{

package/dist/search/search.js

@@ -2,6 +2,7 @@
 import { z } from "zod/v4";
 import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
 import { HarnessRunEnvironmentSchema } from "../harness/run-environment.js";
+import { WebSearchProviderSchema } from "../web/search-provider.js";
 const SearchSchemaDefinition = z.object({
     /** Allow intentional money-like text without a currency marker; prefer --from-file. */
     allowSuspectedShellStrip: z.boolean().nullish(),
@@ -11,12 +12,14 @@ const SearchSchemaDefinition = z.object({
     cacheKey: z.string().nullish(),
     /** Server-selected search catalog revision. */
     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. */
+    /** 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, 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). Without it, a search whose token is still live fetches the overview in the background and later reads return it. 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. */
+    /** 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). With the flag false, a harness-run credential fetches from a live token only and never reruns a search. Without either, 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. */
     deferredAiOverview: z.boolean().default(false).optional(),
     /** Search language code */
     language: z.string().nullish(),
+    /** Provider to search; omitted keeps the default, SerpAPI. EXA runs Exa's instant search with highlights and never falls back to SerpAPI: an Exa failure answers 503. EXA_DEEP runs Exa's slower, broader deep search (higher recall for market and provider questions, about 3-6 s) and falls back to SerpAPI on an Exa failure. Both Exa providers answer synchronously (`Prefer: respond-async` does not apply), are stored apart from SerpAPI results, and are charged like any search. */
+    provider: WebSearchProviderSchema.nullish(),
     /** Search region code */
     region: z.string().nullish(),
     /** Maximum number of normalized results to keep */

package/dist/web/search-provider.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+/**
+ * Upstream web search provider: SERPAPI is Google results through SerpAPI, EXA is Exa's instant search with highlights, and EXA_DEEP is Exa's slower, broader deep search.
+ *
+ * @openapiSchema WebSearchProvider
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSchema
+ * @contractShape web.search-provider
+ * @contractRole canonical
+ */
+export declare const WebSearchProviderSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    EXA: "EXA";
+    EXA_DEEP: "EXA_DEEP";
+    SERPAPI: "SERPAPI";
+}>, z.ZodString]>;
+export type WebSearchProvider = z.infer<typeof WebSearchProviderSchema>;
+//# sourceMappingURL=search-provider.d.ts.map

package/dist/web/search-provider.js

@@ -0,0 +1,17 @@
+// 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";
+/**
+ * Upstream web search provider: SERPAPI is Google results through SerpAPI, EXA is Exa's instant search with highlights, and EXA_DEEP is Exa's slower, broader deep search.
+ *
+ * @openapiSchema WebSearchProvider
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSchema
+ * @contractShape web.search-provider
+ * @contractRole canonical
+ */
+export const WebSearchProviderSchema = z.union([
+    z.enum(["SERPAPI", "EXA", "EXA_DEEP"]),
+    z.string(),
+]);
+//# sourceMappingURL=search-provider.js.map

package/dist/web/search.d.ts

@@ -66,6 +66,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
+        provider?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;
         retrievedFor?: {
@@ -84,6 +85,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
+        provider?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;
         retrievedFor?: {

package/dist/web/search.js

@@ -5,7 +5,7 @@ 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 its deferred overview is stored (fetched in the background after an earlier search, or waited for with `deferredAiOverview`); null when Google produced none or its deferred overview is not stored yet */
+    /** 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(),
     /** Source-document ledger row backing this result */
     document: SourceDocumentListSchema,

package/package.json

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