@aventurevc/api-schemas 0.8.224 → 0.8.225

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: {

package/dist/federated/search.js

@@ -21,6 +21,8 @@ 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: the query names a person, a web-found person's profile shows, or the query asks for people by a search catalog people term. */
+    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. */

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: {
@@ -9464,6 +9465,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 };
             }[] | null | undefined;
         }[];
+        personLead: boolean;
         provenance: {
             answerUnavailable: boolean;
             entity: {

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: {
@@ -9475,6 +9476,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                 };
             }[] | null | undefined;
         }[];
+        personLead: boolean;
         provenance: {
             answerUnavailable: boolean;
             entity: {

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.225",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",