@aventurevc/api-schemas 0.8.436 → 0.8.437

package/dist/harness/run-create.js

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
 import { EnrichmentModeSchema } from "../enrichment/mode.js";
 import { HarnessTaskInputBindingSchema } from "./task-input-binding.js";
 import { ResearchFindingSchema } from "../research/finding.js";
+import { ResearchRunSearchContextSchema } from "../research/run-search-context.js";
 const HarnessRunCreateSchemaDefinition = z.object({
     /** Facts you already read verbatim on an external source page for an entity, each citing the page and exact text that support it. Omit taskPresetKey to default to apply-cited-findings, or send a preset from GET /v1/research/runs/presets; the run checks each quote against its page and writes only the facts it confirms. When the detail comes from an indexed news article or a page not read verbatim, send userPrompt instead. */
     finding: z.array(ResearchFindingSchema).nullish(),
@@ -12,13 +13,16 @@ const HarnessRunCreateSchemaDefinition = z.object({
     model: z.string().nullish(),
     /** Name of the subject at url, such as Clarity Health; the run verifies it and uses it to pick the right subject when the site names several */
     name: z.string().max(200).nullish(),
+    searchContext: ResearchRunSearchContextSchema.nullish(),
+    /** Evidence pages for a report question; never subject identities. */
+    sourceUrl: z.array(z.string()).max(20).optional(),
     /** Requester values keyed by the selected task's input definitions. ENTITY binds from url and a supplied entityId must match it; a task declaring several ENTITY inputs binds one from url and takes each other as the keyed entityId of an existing record (404 when none exists). TEXT requires explicit text; a missing required or ambiguous supplied value is rejected before enqueue; omitted optional inputs stay unbound. Never infer values from userPrompt. */
     taskInput: z.array(HarnessTaskInputBindingSchema).optional(),
     /** Research presets that focus the run, listed by GET /v1/research/runs/presets; omit them for a full run */
     taskPresetKey: z.array(z.string()).nullish(),
-    /** Official website or profile URL of the company, Product, Service, or person to research; a URL no current record owns researches a new one */
-    url: z.string(),
-    /** Optional steering prompt, such as an observed update and its source URL (newsUrlOriginal or web URL) or which facts to check first */
+    /** Official website or profile URL of the company, Product, Service, or person to research; omit only for a selected report task */
+    url: z.string().optional(),
+    /** The question a report task must answer, or steering instructions for enrichment */
     userPrompt: z.string().nullish(),
 });
 /**

package/dist/int/range.d.ts

@@ -21,6 +21,7 @@ export interface IntRangeSchemaInput extends z.input<typeof IntRangeSchemaDefini
  * @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/int/range.js

@@ -21,6 +21,7 @@ const IntRangeSchemaDefinition = 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/investor/activity-filter.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/investor/activity-filter.js

@@ -17,6 +17,7 @@ import { IntRangeSchema } from "../int/range.js";
  * @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/investor/name-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/investor/name-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/dist/natural/search.d.ts

@@ -55,10 +55,12 @@ export interface NaturalSearchSchemaInput extends z.input<typeof NaturalSearchSc
  *
  * @openapiSchema NaturalSearch
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people
  * @usedBySchema EntityNaturalSearchSchema
  * @usedBySchema PersonNaturalSearchSchema
+ * @usedBySchema ResearchRunSearchContextSchema
  * @contractShape natural.search
  * @contractRole canonical
  */

package/dist/natural/search.js

@@ -25,10 +25,12 @@ const NaturalSearchSchemaDefinition = z.object({
  *
  * @openapiSchema NaturalSearch
  * @endpoint POST /v1/content/search
+ * @endpoint POST /v1/research/runs
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people
  * @usedBySchema EntityNaturalSearchSchema
  * @usedBySchema PersonNaturalSearchSchema
+ * @usedBySchema ResearchRunSearchContextSchema
  * @contractShape natural.search
  * @contractRole canonical
  */

package/dist/openapi-component-manifest.js

@@ -1174,6 +1174,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "research/run-report-source",
         schemaName: "ResearchRunReportSourceSchema",
     },
+    ResearchRunSearchContext: {
+        modulePath: "research/run-search-context",
+        schemaName: "ResearchRunSearchContextSchema",
+    },
     ResearchRunView: { modulePath: "research/run-view", schemaName: "ResearchRunViewSchema" },
     ResearchSnippetType: {
         modulePath: "research/snippet-type",

package/dist/person/association-tenure.d.ts

@@ -11,6 +11,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/directory/exports
  * @endpoint POST /v1/directory/shared
  * @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/person/association-tenure.js

@@ -12,6 +12,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/directory/exports
  * @endpoint POST /v1/directory/shared
  * @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/person/filter.d.ts

@@ -11,6 +11,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/directory/exports
  * @endpoint POST /v1/directory/shared
  * @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/person/filter.js

@@ -17,6 +17,7 @@ import { PersonListArrayFilterSchema } from "./list-array-filter.js";
  * @endpoint POST /v1/directory/exports
  * @endpoint POST /v1/directory/shared
  * @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/person/list-array-filter.d.ts

@@ -11,6 +11,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/directory/exports
  * @endpoint POST /v1/directory/shared
  * @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/person/list-array-filter.js

@@ -15,6 +15,7 @@ import { IntRangeSchema } from "../int/range.js";
  * @endpoint POST /v1/directory/exports
  * @endpoint POST /v1/directory/shared
  * @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/publication/publication.js

@@ -15,7 +15,7 @@ const PublicationSchemaDefinition = z.object({
     publishedAt: z.iso.datetime({ offset: true }).nullish(),
     /** How this content relates to the requested owner. */
     relation: PublicationRelationSchema.nullish(),
-    /** CDN URL of the newest screenshot of this page. Only webPage cards for the first page of a section the web-crawl contract flags for screenshots carry one; null for other cards and before the first capture. */
+    /** CDN URL of a stored screenshot of this content card's exact primary URL. Available for any publication type; absent until a capture is stored. */
     screenshotUrl: z.string().nullish(),
     /** Registrable source domain when known. */
     sourceDomain: z.string().nullish(),

package/dist/reasoning/effort.d.ts

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  *
  * @openapiSchema ReasoningEffort
  * @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/reasoning/effort.js

@@ -13,6 +13,7 @@ const ReasoningEffortSchemaKnownMembers = z.enum([
  *
  * @openapiSchema ReasoningEffort
  * @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