@aventurevc/api-schemas 0.8.79 → 0.8.80

package/dist/entity/list-filter.js

@@ -61,7 +61,7 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     portfolioHeadquartersState: z.array(z.string()).optional(),
     /** Named server-owned list quality gate. */
     qualityGate: EntityListQualityGateSchema.optional(),
-    /** Semantic entity search phrase. Executable on POST /v1/entities/search; saved views persist it for replay. */
+    /** Semantic entity search phrase. Executable on POST /v1/entities/search; saved views persist it for replay. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching entity. */
     semanticQuery: z.string().nullish(),
     /** Restrict results to entity slugs. */
     slug: z

package/dist/entity/person-owner.d.ts

@@ -12,6 +12,7 @@ import { z } from "zod/v4";
  * @usedBySchema IdentificationCandidateSchema
  * @usedBySchema LookupJobMentionSchema
  * @usedBySchema ResolvedHandleSchema
+ * @usedBySchema SearchSchema
  * @usedBySchema UniqueIdSchema
  * @usedBySchema UrlDuplicateConflictSchema
  * @usedBySchema UrlDuplicateJoinSchema

package/dist/entity/person-owner.js

@@ -13,6 +13,7 @@ import { z } from "zod/v4";
  * @usedBySchema IdentificationCandidateSchema
  * @usedBySchema LookupJobMentionSchema
  * @usedBySchema ResolvedHandleSchema
+ * @usedBySchema SearchSchema
  * @usedBySchema UniqueIdSchema
  * @usedBySchema UrlDuplicateConflictSchema
  * @usedBySchema UrlDuplicateJoinSchema

package/dist/person/filter.js

@@ -45,7 +45,7 @@ export const PersonFilterSchema = z.object({
     role: z.string().nullish(),
     /** Search keyword or phrase. Single characters valid; stop words rejected. */
     search: z.string().nullish(),
-    /** Semantic person search phrase. */
+    /** Semantic person search phrase. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching person. */
     semanticQuery: z.string().nullish(),
     /** Person workflow status. */
     status: z.string().nullish(),

package/dist/search/search.d.ts

@@ -3,11 +3,13 @@ declare const SearchSchemaDefinition: z.ZodObject<{
     allowSuspectedShellStrip: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     bypassCache: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     cacheKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     resultLimit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    retrievedFor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>>>;
     search: z.ZodString;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;

package/dist/search/search.js

@@ -1,5 +1,6 @@
 // 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 { EntityPersonOwnerSchema } from "../entity/person-owner.js";
 const SearchSchemaDefinition = z.object({
     /** Allow intentional money-like text without a currency marker; prefer --from-file. */
     allowSuspectedShellStrip: z.boolean().nullish(),
@@ -7,16 +8,14 @@ const SearchSchemaDefinition = z.object({
     bypassCache: z.boolean().default(false).optional(),
     /** Stable lookup text for cache keying when generated search text varies between runs */
     cacheKey: z.string().nullish(),
-    /** Entity this search was retrieved for: its stored result lists under that entity (`GET /v1/research/source-documents?entityId=`) on a fetch or a cache hit */
-    entityId: z.uuid().nullish(),
     /** Search language code */
     language: z.string().nullish(),
-    /** Person this search was retrieved for: its stored result lists under that person (`GET /v1/research/source-documents?personId=`) on a fetch or a cache hit */
-    personId: z.uuid().nullish(),
     /** Search region code */
     region: z.string().nullish(),
     /** Maximum number of normalized results to keep */
     resultLimit: z.int().nullish(),
+    /** Entity or person this search was retrieved for: its stored result lists under that subject (`GET /v1/research/source-documents?entityId=` or `?personId=`) on a fetch or a cache hit */
+    retrievedFor: EntityPersonOwnerSchema.nullish(),
     /** Search text sent to the upstream web search provider */
     search: z.string(),
     /** Optional caller identity, up to 64 characters, persisted for source-document attribution and abuse triage. Agent requests derive `<agentModel>-<agentChassis>` from the validated provenance actor instead of this field. */

package/dist/web/search.d.ts

@@ -46,22 +46,26 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
-        entityId?: string | null | undefined;
         language?: string | null | undefined;
-        personId?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;
+        retrievedFor?: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        } | null | undefined;
         search: string;
         source?: string | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
-        entityId?: string | null | undefined;
         language?: string | null | undefined;
-        personId?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;
+        retrievedFor?: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        } | null | undefined;
         search: string;
         source?: string | null | undefined;
     }, unknown>>;

package/package.json

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