@aventurevc/api-schemas 0.8.224 → 0.8.226

package/dist/enrichment/batch.d.ts

@@ -6,6 +6,7 @@ declare const EnrichmentBatchSchemaDefinition: z.ZodObject<{
         INDIVIDUAL: "INDIVIDUAL";
     }>>;
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    newsId: z.ZodOptional<z.ZodArray<z.ZodInt>>;
     personId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
     taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/enrichment/batch.js

@@ -8,6 +8,8 @@ const EnrichmentBatchSchemaDefinition = z.object({
     mode: EnrichmentModeSchema.optional(),
     /** Model id for each run's lead agent; omit to use aVenture's default model */
     model: z.string().nullish(),
+    /** News article ids. The server identifies every company and person each article names, as POST /v1/lookup-mentions does with sourceNewsId, adds the article's linked companies and people, and files one enrichment per distinct record. */
+    newsId: z.array(z.int()).optional(),
     /** Canonical person UUIDs to enrich, filed in order after every entity */
     personId: z.array(z.uuid()).optional(),
     /** Task preset keys that scope or emphasize every run; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400 */

package/dist/entity/detail-batch.d.ts

@@ -9,7 +9,7 @@ type EntityDetailBatchDefinition = z.infer<typeof EntityDetailBatchSchemaDefinit
 export interface EntityDetailBatchSchemaInput extends z.input<typeof EntityDetailBatchSchemaDefinition> {
 }
 /**
- * Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url.
+ * Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url. It takes no names: identify a company by name with lookupRecord and its name field.
  *
  * @openapiSchema EntityDetailBatch
  * @endpoint POST /v1/entities/lookup-batch

package/dist/entity/detail-batch.js

@@ -24,7 +24,7 @@ const EntityDetailBatchSchemaDefinition = z
     }
 });
 /**
- * Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url.
+ * Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url. It takes no names: identify a company by name with lookupRecord and its name field.
  *
  * @openapiSchema EntityDetailBatch
  * @endpoint POST /v1/entities/lookup-batch

package/dist/entity/filter.js

@@ -106,7 +106,7 @@ export const EntityFilterSchema = z.strictObject({
     suppressZeroTotalRaised: z.boolean().nullish(),
     /** General classification tag values. */
     tag: z.array(z.string()).optional(),
-    /** Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests. */
+    /** Non-blank company-identity search term: it matches only brand names, legal names, slugs, and name aliases (including near spellings of them), never descriptions, products, or topics. A topic, sector, or market word such as "climate" or "corporate card" returns no rows or name lookalikes here: filter by the industry, tag, mainProduct, or other classification fields, send the phrase as semanticQuery on POST /v1/entities/search, or ask natural search for plain-English or multi-constraint company requests. */
     textSearch: z.string().nullish(),
     /** Customer-type classification values. */
     typeCustomer: z.array(z.string()).optional(),

package/dist/entity/list-filter.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Entity list filters and saved-view query state including semantic entity search. semanticQuery executes on GET /v1/entities and POST /v1/entities/search; saved views persist it for replay. Every other reused EntityFilter surface accepts the base EntityFilter, which omits semanticQuery. There is no query field: send free text describing the companies as semanticQuery, a keyword as textSearch, or a known company name as entityName.
+ * Entity list filters and saved-view query state including semantic entity search. semanticQuery executes on GET /v1/entities and POST /v1/entities/search; saved views persist it for replay. Every other reused EntityFilter surface accepts the base EntityFilter, which omits semanticQuery. There is no query field: send free text describing the companies as semanticQuery, a word of a company's name, legal name, slug, or alias as textSearch, or a known company name as entityName.
  *
  * @openapiSchema EntityListFilter
  * @endpoint GET /v1/search/link

package/dist/entity/list-filter.js

@@ -9,7 +9,7 @@ import { EntityUrlTypeSchema } from "./url-type.js";
 import { IntRangeSchema } from "../int/range.js";
 import { UrlMatchModeSchema } from "../url/match-mode.js";
 /**
- * Entity list filters and saved-view query state including semantic entity search. semanticQuery executes on GET /v1/entities and POST /v1/entities/search; saved views persist it for replay. Every other reused EntityFilter surface accepts the base EntityFilter, which omits semanticQuery. There is no query field: send free text describing the companies as semanticQuery, a keyword as textSearch, or a known company name as entityName.
+ * Entity list filters and saved-view query state including semantic entity search. semanticQuery executes on GET /v1/entities and POST /v1/entities/search; saved views persist it for replay. Every other reused EntityFilter surface accepts the base EntityFilter, which omits semanticQuery. There is no query field: send free text describing the companies as semanticQuery, a word of a company's name, legal name, slug, or alias as textSearch, or a known company name as entityName.
  *
  * @openapiSchema EntityListFilter
  * @endpoint GET /v1/search/link
@@ -104,7 +104,7 @@ export const EntityListFilterSchema = z.strictObject({
     suppressZeroTotalRaised: z.boolean().nullish(),
     /** General classification tag values. */
     tag: z.array(z.string()).optional(),
-    /** Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests. */
+    /** Non-blank company-identity search term: it matches only brand names, legal names, slugs, and name aliases (including near spellings of them), never descriptions, products, or topics. A topic, sector, or market word such as "climate" or "corporate card" returns no rows or name lookalikes here: filter by the industry, tag, mainProduct, or other classification fields, send the phrase as semanticQuery on POST /v1/entities/search, or ask natural search for plain-English or multi-constraint company requests. */
     textSearch: z.string().nullish(),
     /** Customer-type classification values. */
     typeCustomer: z.array(z.string()).optional(),

package/dist/federated/search.d.ts

@@ -9345,6 +9345,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             };
         }[] | null | undefined;
     }, import("../person/detail.ts").PersonDetailSchemaInput>>>;
+    personLead: z.ZodBoolean;
     provenance: z.ZodType<{
         answerUnavailable: boolean;
         entity: {
@@ -9397,6 +9398,12 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         }, import("../search/qualifier-option.ts").SearchQualifierOptionSchemaInput>>>;
         prompt: z.ZodString;
     }, z.core.$strip>>>;
+    section: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        company: "company";
+        investor: "investor";
+        person: "person";
+        productService: "productService";
+    }>>>;
 }, z.core.$strip>;
 type FederatedSearchDefinition = z.infer<typeof FederatedSearchSchemaDefinition>;
 export interface FederatedSearchSchemaInput extends z.input<typeof FederatedSearchSchemaDefinition> {

package/dist/federated/search.js

@@ -21,10 +21,14 @@ const FederatedSearchSchemaDefinition = z.object({
     person: PersonNaturalSearchResultSchema,
     /** Public detail for people on the person result page, in search rank order, with at most two public entity associations per person; person address and URL enrichment is omitted. */
     personDetail: z.array(PersonDetailSchema),
+    /** Whether people lead this page: `section` starts with `person`. */
+    personLead: z.boolean(),
     /** Requested and executed strategy for each search scope. */
     provenance: FederatedSearchProvenanceSchema,
     /** A prompt with rewritten queries offered beside a broad query's results, from the search catalog revision the search read; null when no qualifier rule matches. */
     qualifier: SearchQualifierSchema.nullish(),
+    /** Result sections from most to least relevant. People lead when the query names a person, a web-found person's profile shows, or the query asks for people by a search catalog people term, and come last otherwise. Companies, products and services, and investors follow the rank of each section's best entity row, so a name whose best match is an investment firm leads with investors; sections with no entity row follow in that same fixed order. */
+    section: z.array(z.enum(["person", "company", "productService", "investor"])).optional(),
 });
 /**
  * Federated entity, person, and news search result composed from each domain's canonical search result owner, with the strategy used for every scope.

package/dist/harness/run-detail.d.ts

@@ -60,6 +60,7 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
         hasMore: z.ZodBoolean;
         runId: z.ZodArray<z.ZodUUID>;
     }, z.core.$strip>>;
+    lastEventAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     latestStatus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         complete: z.ZodBoolean;
         entitySlug: z.ZodNullable<z.ZodString>;

package/dist/harness/run-detail.js

@@ -9,6 +9,8 @@ const HarnessRunDetailSchemaDefinition = z.object({
     entity: EntitySchema.nullish(),
     /** Follow-up admission and direct child run ids for this terminal generation */
     followUp: HarnessRunFollowUpSchema.optional(),
+    /** Time the run's newest stream event was recorded; null when the run has no events. A running run whose value stops advancing has stalled */
+    lastEventAt: z.iso.datetime({ offset: true }).nullish(),
     /** Latest research progress; null when none is available */
     latestStatus: HarnessRunProgressSchema.nullish(),
     /** Parent organization's core record when the resolved entity is a Product/Service; null for every other entity type */

package/dist/link/search.d.ts

@@ -4718,6 +4718,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 };
             }[] | null | undefined;
         }[];
+        personLead: boolean;
         provenance: {
             answerUnavailable: boolean;
             entity: {
@@ -4747,6 +4748,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             }[];
             prompt: string;
         } | null | undefined;
+        section?: ("company" | "investor" | "person" | "productService")[] | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput, z.core.$ZodTypeInternals<{
         entity: {
             answer?: {
@@ -9464,6 +9466,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 };
             }[] | null | undefined;
         }[];
+        personLead: boolean;
         provenance: {
             answerUnavailable: boolean;
             entity: {
@@ -9493,6 +9496,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             }[];
             prompt: string;
         } | null | undefined;
+        section?: ("company" | "investor" | "person" | "productService")[] | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput>>;
     url: z.ZodString;
 }, z.core.$strip>;

package/dist/news/param.d.ts

@@ -15,6 +15,7 @@ export declare const NewsParamSchema: z.ZodObject<{
     sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     category: z.ZodOptional<z.ZodString>;
     excludeId: z.ZodOptional<z.ZodInt>;
+    newsId: z.ZodOptional<z.ZodArray<z.ZodInt>>;
     "owner.entityId": z.ZodOptional<z.ZodUUID>;
     "owner.personId": z.ZodOptional<z.ZodUUID>;
     publishedAfter: z.ZodOptional<z.ZodISODate>;

package/dist/news/param.js

@@ -16,6 +16,8 @@ export const NewsParamSchema = PageParamSchema.extend({
     category: z.string().optional(),
     /** Exclude one news article by id. */
     excludeId: z.int().optional(),
+    /** Return only these news article ids. */
+    newsId: z.array(z.int()).max(200).optional(),
     /** Owning entity id; set only when personId is absent. */
     "owner.entityId": z.uuid().optional(),
     /** Owning person id; set only when entityId is absent. */

package/dist/person/lookup-exact-param.js

@@ -23,9 +23,9 @@ export const PersonLookupExactParamSchema = z.object({
     location: z.string().optional(),
     /** Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40. */
     maxAssociations: z.int().optional(),
-    /** Group C — candidate lookup signal: loose name match (any of given/family/full). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback. */
+    /** Group C — candidate lookup signal: loose name match (any of given/family/full). A name alone never resolves; combine it with other group-C signals or url. Mutually exclusive with id and slug. */
     nameAny: z.string().optional(),
-    /** Group C — candidate lookup signal: person full name. Combine with other group-C signals (nameAny, location, urlDomain) for bounded candidate search. Mutually exclusive with id and slug; may be combined with url for fallback. */
+    /** Group C — candidate lookup signal: person full name. A name alone never resolves (404): pair it with other group-C signals (location, urlDomain) or url. To find a person by name, use lookupRecord with kind PERSON; for the people at a company, use listEntityPersonAssociations. Mutually exclusive with id and slug. */
     nameFull: z.string().optional(),
     /** Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response. */
     permitMonogram: z.boolean().optional(),

package/dist/search/hit.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod/v4";
 declare const SearchHitSchemaDefinition: z.ZodObject<{
+    image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     relevanceScore: z.ZodNumber;
     snippet: z.ZodString;
     title: z.ZodString;

package/dist/search/hit.js

@@ -1,6 +1,8 @@
 // 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 SearchHitSchemaDefinition = z.object({
+    /** Image the provider attached to this result (a LinkedIn profile's headshot); null when it attached none. */
+    image: z.string().nullish(),
     relevanceScore: z.number(),
     snippet: z.string(),
     title: z.string(),

package/dist/search/person-profile.js

@@ -15,7 +15,7 @@ const SearchPersonProfileSchemaDefinition = z.object({
     named: z.string(),
     /** Where the profile names the organization the query paired with the person: in its headline, elsewhere in the profile text, or not at all; null when the query named no organization. */
     organizationEvidence: z.enum(["headline", "profile", "none"]).nullish(),
-    /** Headshot URL from aVenture's stored LinkedIn capture; null until one is stored or when the capture holds no usable headshot. */
+    /** Headshot URL: the web search index's LinkedIn headshot until aVenture's stored LinkedIn capture supplies one; null when neither holds a usable headshot. */
     photoUrl: z.string().nullish(),
     /** Canonical aVenture person page URL; never an external profile URL. */
     profileUrl: z.string(),

package/dist/shared/search.d.ts

@@ -4729,6 +4729,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                 };
             }[] | null | undefined;
         }[];
+        personLead: boolean;
         provenance: {
             answerUnavailable: boolean;
             entity: {
@@ -4758,6 +4759,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
             }[];
             prompt: string;
         } | null | undefined;
+        section?: ("company" | "investor" | "person" | "productService")[] | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput, z.core.$ZodTypeInternals<{
         entity: {
             answer?: {
@@ -9475,6 +9477,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                 };
             }[] | null | undefined;
         }[];
+        personLead: boolean;
         provenance: {
             answerUnavailable: boolean;
             entity: {
@@ -9504,6 +9507,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
             }[];
             prompt: string;
         } | null | undefined;
+        section?: ("company" | "investor" | "person" | "productService")[] | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput>>;
 }, z.core.$strip>;
 type SharedSearchDefinition = z.infer<typeof SharedSearchSchemaDefinition>;

package/dist/web/search.d.ts

@@ -80,11 +80,13 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
     }, import("../search/related-question.ts").SearchRelatedQuestionSchemaInput>>>>>;
     relatedSearch: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     result: z.ZodArray<z.ZodType<{
+        image?: string | null | undefined;
         relevanceScore: number;
         snippet: string;
         title: string;
         url: string;
     }, import("../search/hit.ts").SearchHitSchemaInput, z.core.$ZodTypeInternals<{
+        image?: string | null | undefined;
         relevanceScore: number;
         snippet: string;
         title: string;

package/package.json

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