@aventurevc/api-schemas 0.8.232 → 0.8.234

package/dist/entity/provider.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * The current entity a fund or product/service is offered by: a fund's manager firm, a product/service's provider, through its current primary edge to a live, listed provider. Null on every other entity type.
+ * The current entity a fund or product/service is offered by: a fund's manager organization, a product/service's provider, through its current primary edge to a live, listed provider. Null on every other entity type.
  *
  * @openapiSchema EntityProvider
  * @endpoint GET /v1/entities

package/dist/entity/provider.js

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 import { AddressSchema } from "../address/address.js";
 import { EntitySchema } from "./entity.js";
 /**
- * The current entity a fund or product/service is offered by: a fund's manager firm, a product/service's provider, through its current primary edge to a live, listed provider. Null on every other entity type.
+ * The current entity a fund or product/service is offered by: a fund's manager organization, a product/service's provider, through its current primary edge to a live, listed provider. Null on every other entity type.
  *
  * @openapiSchema EntityProvider
  * @endpoint GET /v1/entities

package/dist/federated/search.d.ts

@@ -916,6 +916,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             };
         }[];
         pendingWebQuery: string[];
+        personLead: boolean;
         result: {
             content: {
                 core: {
@@ -2931,6 +2932,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             };
         }[];
         pendingWebQuery: string[];
+        personLead: boolean;
         result: {
             content: {
                 core: {
@@ -6940,6 +6942,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
     person: z.ZodType<{
         interpretation: {
             confidence: "HIGH" | "LOW" | "MEDIUM";
+            employerSemanticQuery?: string | null | undefined;
             execution: {
                 modeRequested: string;
                 modeUsed: string;
@@ -7272,6 +7275,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 sourceType: string;
             } | null | undefined;
         }[];
+        personLead: boolean;
         profile: {
             currentCompany?: string | null | undefined;
             headline?: string | null | undefined;
@@ -7334,6 +7338,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
     }, import("../person/natural-search-result.ts").PersonNaturalSearchResultSchemaInput, z.core.$ZodTypeInternals<{
         interpretation: {
             confidence: "HIGH" | "LOW" | "MEDIUM";
+            employerSemanticQuery?: string | null | undefined;
             execution: {
                 modeRequested: string;
                 modeUsed: string;
@@ -7666,6 +7671,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 sourceType: string;
             } | null | undefined;
         }[];
+        personLead: boolean;
         profile: {
             currentCompany?: string | null | undefined;
             headline?: string | null | undefined;

package/dist/link/search.d.ts

@@ -918,6 +918,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 };
             }[];
             pendingWebQuery: string[];
+            personLead: boolean;
             result: {
                 content: {
                     core: {
@@ -3516,6 +3517,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
         person: {
             interpretation: {
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                employerSemanticQuery?: string | null | undefined;
                 execution: {
                     modeRequested: string;
                     modeUsed: string;
@@ -3848,6 +3850,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     sourceType: string;
                 } | null | undefined;
             }[];
+            personLead: boolean;
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;
@@ -5666,6 +5669,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 };
             }[];
             pendingWebQuery: string[];
+            personLead: boolean;
             result: {
                 content: {
                     core: {
@@ -8264,6 +8268,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
         person: {
             interpretation: {
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                employerSemanticQuery?: string | null | undefined;
                 execution: {
                     modeRequested: string;
                     modeUsed: string;
@@ -8596,6 +8601,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     sourceType: string;
                 } | null | undefined;
             }[];
+            personLead: boolean;
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;

package/dist/natural/search-result.d.ts

@@ -1816,6 +1816,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
         };
     }, import("../entity/similarity-result.ts").EntitySimilarityResultSchemaInput>>>;
     pendingWebQuery: z.ZodArray<z.ZodString>;
+    personLead: z.ZodBoolean;
     result: z.ZodType<{
         content: {
             core: {

package/dist/natural/search-result.js

@@ -26,6 +26,8 @@ const NaturalSearchResultSchemaDefinition = z.object({
     peer: z.array(EntitySimilarityResultSchema),
     /** Web searches for this question not yet stored; their evidence joins a later request. Empty without the `web` layer. */
     pendingWebQuery: z.array(z.string()),
+    /** Whether people lead this search, stamped only on entity stream events. */
+    personLead: z.boolean(),
     /** Entity list page returned by the canonical entity list engine. */
     result: PageResultEntityListSchema,
     /** Id of this search's stored record. Null when the search was not recorded. */

package/dist/person/natural-search-result.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
     interpretation: z.ZodType<{
         confidence: "HIGH" | "LOW" | "MEDIUM";
+        employerSemanticQuery?: string | null | undefined;
         execution: {
             modeRequested: string;
             modeUsed: string;
@@ -186,6 +187,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
         unsupported?: string | null | undefined;
     }, import("./search-interpretation.ts").PersonSearchInterpretationSchemaInput, z.core.$ZodTypeInternals<{
         confidence: "HIGH" | "LOW" | "MEDIUM";
+        employerSemanticQuery?: string | null | undefined;
         execution: {
             modeRequested: string;
             modeUsed: string;
@@ -666,6 +668,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
             sourceType: string;
         } | null | undefined;
     }, import("../search/investment.ts").SearchInvestmentSchemaInput>>>;
+    personLead: z.ZodBoolean;
     profile: z.ZodArray<z.ZodType<{
         currentCompany?: string | null | undefined;
         headline?: string | null | undefined;

package/dist/person/natural-search-result.js

@@ -9,6 +9,8 @@ const PersonNaturalSearchResultSchemaDefinition = z.object({
     interpretation: PersonSearchInterpretationSchema,
     /** Personal investment participation supporting the returned people. Firm portfolio activity is never attributed to employees. Empty for other question intents. */
     investment: z.array(SearchInvestmentSchema),
+    /** Whether people are the confirmed requested focus of this search. */
+    personLead: z.boolean(),
     /** aVenture people resolved or filed from web-discovered LinkedIn profiles whom no returned person matches, grouped by `named` in query order. A search that has not run yet runs only for a signed-in subscriber with `layer=web`. */
     profile: z.array(SearchPersonProfileSchema),
     /** Person page returned by the canonical person list engine. */

package/dist/person/search-interpretation.d.ts

@@ -5,6 +5,7 @@ declare const PersonSearchInterpretationSchemaDefinition: z.ZodObject<{
         LOW: "LOW";
         MEDIUM: "MEDIUM";
     }>;
+    employerSemanticQuery: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     execution: z.ZodType<{
         modeRequested: string;
         modeUsed: string;

package/dist/person/search-interpretation.js

@@ -5,8 +5,10 @@ import { PersonFilterSchema } from "./filter.js";
 import { SearchModeExecutionSchema } from "../search/mode-execution.js";
 import { SearchOrderingPersonSortFieldSchema } from "../search/ordering-person-sort-field.js";
 const PersonSearchInterpretationSchemaDefinition = z.object({
-    /** Planner confidence in the structured interpretation. */
+    /** Confidence in interpreting the request as this structured people query. */
     confidence: ConfidenceSchema,
+    /** Employer-business topic resolved through entity similarity before people paging. Matching employer IDs narrow filter.entityFilter.entityId; an empty selection returns no people without removing hard constraints. Employer kinds exclude Product and Service records, which are offerings rather than employers. Personal expertise stays in filter.semanticQuery. Null when employer selection is entirely structured. */
+    employerSemanticQuery: z.string().nullish(),
     /** Requested and executed search strategy. */
     execution: SearchModeExecutionSchema,
     /** True when the semantic fallback replaced an unconstrained planner result with a semantic search over the original query. */

package/dist/search/person-profile.js

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 const SearchPersonProfileSchemaDefinition = z.object({
     /** Current company named by aVenture's stored LinkedIn capture; null until one is stored. */
     currentCompany: z.string().nullish(),
-    /** Profile headline as the web search index holds it; null when it has none. */
+    /** Profile headline from aVenture's stored LinkedIn capture, or the web search index until a capture is stored; null when that source has no headline. */
     headline: z.string().nullish(),
     /** Canonical aVenture person id. */
     id: z.uuid(),

package/dist/shared/search.d.ts

@@ -929,6 +929,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                 };
             }[];
             pendingWebQuery: string[];
+            personLead: boolean;
             result: {
                 content: {
                     core: {
@@ -3527,6 +3528,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
         person: {
             interpretation: {
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                employerSemanticQuery?: string | null | undefined;
                 execution: {
                     modeRequested: string;
                     modeUsed: string;
@@ -3859,6 +3861,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     sourceType: string;
                 } | null | undefined;
             }[];
+            personLead: boolean;
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;
@@ -5677,6 +5680,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                 };
             }[];
             pendingWebQuery: string[];
+            personLead: boolean;
             result: {
                 content: {
                     core: {
@@ -8275,6 +8279,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
         person: {
             interpretation: {
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                employerSemanticQuery?: string | null | undefined;
                 execution: {
                     modeRequested: string;
                     modeUsed: string;
@@ -8607,6 +8612,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     sourceType: string;
                 } | null | undefined;
             }[];
+            personLead: boolean;
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;

package/package.json

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