@aventurevc/api-schemas 0.8.435 → 0.8.437

package/dist/research/run-search-context.js

@@ -0,0 +1,18 @@
+// 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 { NaturalSearchSchema } from "../natural/search.js";
+import { SearchInterpretationSchema } from "../search/interpretation.js";
+/**
+ * The original search request and the interpretation the reader wants checked.
+ *
+ * @openapiSchema ResearchRunSearchContext
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessRunCreateSchema
+ * @contractShape research.run-search-context
+ * @contractRole canonical
+ */
+export const ResearchRunSearchContextSchema = z.object({
+    interpretation: SearchInterpretationSchema,
+    search: NaturalSearchSchema,
+});
+//# sourceMappingURL=run-search-context.js.map

package/dist/search/cache-mode.d.ts

@@ -5,6 +5,7 @@ import { z } from "zod/v4";
  * @openapiSchema SearchCacheMode
  * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/cache-mode.js

@@ -6,6 +6,7 @@ import { z } from "zod/v4";
  * @openapiSchema SearchCacheMode
  * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/freshness.d.ts

@@ -5,6 +5,7 @@ import { z } from "zod/v4";
  * @openapiSchema SearchFreshness
  * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/freshness.js

@@ -6,6 +6,7 @@ import { z } from "zod/v4";
  * @openapiSchema SearchFreshness
  * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/intent.d.ts

@@ -7,6 +7,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared

package/dist/search/intent.js

@@ -8,6 +8,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared

package/dist/search/interpretation.d.ts

@@ -797,10 +797,12 @@ export interface SearchInterpretationSchemaInput extends z.input<typeof SearchIn
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared
  * @usedBySchema NaturalSearchResultSchema
+ * @usedBySchema ResearchRunSearchContextSchema
  * @contractShape search.interpretation
  * @contractRole canonical
  */

package/dist/search/interpretation.js

@@ -36,10 +36,12 @@ const SearchInterpretationSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared
  * @usedBySchema NaturalSearchResultSchema
+ * @usedBySchema ResearchRunSearchContextSchema
  * @contractShape search.interpretation
  * @contractRole canonical
  */

package/dist/search/mode-execution.d.ts

@@ -46,6 +46,7 @@ export interface SearchModeExecutionSchemaInput extends z.input<typeof SearchMod
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/mode-execution.js

@@ -15,6 +15,7 @@ const SearchModeExecutionSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/mode.d.ts

@@ -8,6 +8,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/mode.js

@@ -17,6 +17,7 @@ const SearchModeSchemaKnownMembers = z.enum([
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/ordering-entity-filter-sortable.d.ts

@@ -25,6 +25,7 @@ export interface SearchOrderingEntityFilterSortableSchemaInput extends z.input<t
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared

package/dist/search/ordering-entity-filter-sortable.js

@@ -16,6 +16,7 @@ const SearchOrderingEntityFilterSortableSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared

package/dist/search/relevance.d.ts

@@ -7,6 +7,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/relevance.js

@@ -8,6 +8,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/search/search.js

@@ -25,9 +25,9 @@ const SearchSchemaDefinition = z.object({
     freshness: SearchFreshnessSchema.default("auto").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 to search; omitted keeps the default, SerpAPI. EXA runs Exa's instant search with highlights. EXA_DEEP runs Exa's slower, broader deep search (higher recall for market and provider questions, about 3-6 s). Both name each result's own page, answer synchronously, and fall back to SerpAPI on an Exa failure; `document.provider` names the provider that answered, and a SerpAPI fallback can answer 202 under `Prefer: respond-async`. Exa results are stored apart from SerpAPI results and are charged like any search. */
     provider: WebSearchProviderSchema.nullish(),
-    /** Return only results Google dates within this window; SERPAPI or BRIGHT_DATA only, refused with 400 for other providers. Omitted searches every date. */
+    /** Return only results dated within this window: Google's own result date for SERPAPI and BRIGHT_DATA, the page's publication date for EXA and EXA_DEEP. Omitted searches every date. */
     recency: WebSearchRecencySchema.nullish(),
     /** Search region code */
     region: z.string().nullish(),

package/dist/sort/order-entity-filter-sortable.d.ts

@@ -59,6 +59,7 @@ export interface SortOrderEntityFilterSortableSchemaInput extends z.input<typeof
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared

package/dist/sort/order-entity-filter-sortable.js

@@ -17,6 +17,7 @@ const SortOrderEntityFilterSortableSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared

package/dist/standardized/classification-filter.d.ts

@@ -24,6 +24,7 @@ export interface StandardizedClassificationFilterSchemaInput extends z.input<typ
  * @endpoint POST /v1/entities/filters/search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/standardized/classification-filter.js

@@ -27,6 +27,7 @@ const StandardizedClassificationFilterSchemaDefinition = z.object({
  * @endpoint POST /v1/entities/filters/search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/url/match-mode.d.ts

@@ -14,6 +14,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/entities/filters/search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/url/match-mode.js

@@ -15,6 +15,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/entities/filters/search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/people/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/package.json

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