@aventurevc/api-schemas 0.8.33 → 0.8.34

package/dist/entity/type.d.ts

@@ -9,6 +9,7 @@ import { z } from "zod/v4";
  * @usedBySchema EntityPersonAssociationSchema
  * @usedBySchema EntitySchema
  * @usedBySchema EntityTypeGroupMembershipSchema
+ * @usedBySchema IdentificationSubjectSchema
  * @usedBySchema NewsResolvedEntityLinkSchema
  * @usedBySchema PersonListArrayFilterSchema
  * @usedBySchema SearchDuplicateCandidateScoreSchema

package/dist/entity/type.js

@@ -10,6 +10,7 @@ import { z } from "zod/v4";
  * @usedBySchema EntityPersonAssociationSchema
  * @usedBySchema EntitySchema
  * @usedBySchema EntityTypeGroupMembershipSchema
+ * @usedBySchema IdentificationSubjectSchema
  * @usedBySchema NewsResolvedEntityLinkSchema
  * @usedBySchema PersonListArrayFilterSchema
  * @usedBySchema SearchDuplicateCandidateScoreSchema

package/dist/identification/candidate.js

@@ -17,13 +17,13 @@ import { SearchDuplicateCandidateScoreSchema } from "../search/duplicate-candida
  * @contractRole canonical
  */
 export const IdentificationCandidateSchema = z.object({
-    /** Percentage, 0 to 100, of the company's required completion-floor slots that pass, as last computed by the background coverage sweep; GET /v1/entities/{entityId}/coverage returns the live per-slot detail. Absent for people, who have no completion floor, and for companies not yet computed. */
+    /** Percentage, 0 to 100, of the entity's required completion-floor slots that pass, as last computed by the background coverage sweep; GET /v1/entities/{entityId}/coverage returns the live per-slot detail. Absent for people, who have no completion floor, and for entities not yet computed. */
     dataCompletionCoverage: z.int().min(0).max(100).nullish(),
     /** How this record was checked as the picked record stored again; absent when it was not checked. */
     duplicateBasis: z.enum(["STUB", "SHARED_FACT", "JUDGED"]).nullish(),
     /** Decision-model probability, 0 to 1, that this record is the picked record stored again; present only when duplicateBasis is JUDGED. */
     duplicateProbability: z.number().nullish(),
-    /** Whether the record is a company (entityId) or a person (personId); read it with GET /v1/entities/{entityId} or GET /v1/people/{personId}. */
+    /** Entity identity (entityId) or person identity (personId). record.typeRecord distinguishes a company, product, or service; read it with GET /v1/entities/{entityId} or GET /v1/people/{personId}. */
     owner: EntityPersonOwnerSchema,
     /** Decision-model probability, 0 to 1, that this record is the subject; absent when the answer came from URL proof or the model did not judge this record. */
     probability: z.number().nullish(),

package/dist/identification/identification.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Which existing company or person record a subject is, how that was settled, and the candidates considered, most probable first.
+ * Which existing entity or person satisfies the requested identity, type, and provider scope, how that was settled, and the candidates considered, most probable first.
  *
  * @openapiSchema Identification
  * @endpoint GET /v1/lookup

package/dist/identification/identification.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { IdentificationCandidateSchema } from "./candidate.js";
 /**
- * Which existing company or person record a subject is, how that was settled, and the candidates considered, most probable first.
+ * Which existing entity or person satisfies the requested identity, type, and provider scope, how that was settled, and the candidates considered, most probable first.
  *
  * @openapiSchema Identification
  * @endpoint GET /v1/lookup
@@ -32,7 +32,7 @@ export const IdentificationSchema = z.object({
     officialUrl: z.string().nullish(),
     /** The ladder step that settled the answer. */
     stage: z.enum(["DETERMINISTIC", "JUDGMENT", "WEB_EVIDENCE"]),
-    /** What the caller does next: act on match, create, or ask the user. */
+    /** Use the scoped match, record scoped absence, or refine an ambiguous identity with evidence. */
     status: z.enum(["MATCHED", "NO_MATCH", "NEEDS_REVIEW"]),
 });
 //# sourceMappingURL=identification.js.map

package/dist/identification/subject.d.ts

@@ -3,13 +3,25 @@ declare const IdentificationSubjectSchemaDefinition: z.ZodObject<{
     context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
+    providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    typeRecord: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        "Business Line": "Business Line";
+        Company: "Company";
+        Fund: "Fund";
+        Government: "Government";
+        "Investment Firm": "Investment Firm";
+        Nonprofit: "Nonprofit";
+        Organization: "Organization";
+        Product: "Product";
+        Service: "Service";
+    }>>>;
     url: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type IdentificationSubjectDefinition = z.infer<typeof IdentificationSubjectSchemaDefinition>;
 /**
- * The company or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.
+ * The company, Product, Service, or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.
  *
  * @openapiSchema IdentificationSubject
  * @endpoint POST /v1/entities/lookup

package/dist/identification/subject.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 { EntityTypeSchema } from "../entity/type.js";
 const IdentificationSubjectSchemaDefinition = z.object({
     /** Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing. */
     context: z.string().max(2000).nullish(),
@@ -7,15 +8,19 @@ const IdentificationSubjectSchemaDefinition = z.object({
     location: z.string().max(2000).nullish(),
     /** Name exactly as the source writes it, such as Acme AI or Jane Doe. Required even when url is sent; to read a record from only a URL (an aVenture page, website, or domain) use the exact read instead: entities lookup-exact get --url, or people lookup-exact get --url for a person. */
     name: z.string().max(200),
+    /** Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup. */
+    providerId: z.uuid().nullish(),
     /** aVenture news id of the article that mentions the subject; an unknown id is a 400. */
     sourceNewsId: z.int().nullish(),
     /** URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched. */
     sourceUrl: z.string().max(2000).nullish(),
+    /** Entity type to identify. A Product or Service never matches its provider organization, but a record stored under a neighboring type of the same family (Product or Service; Fund, Investment Firm, or Company) still matches, and a Business Line lookup sees both families. */
+    typeRecord: EntityTypeSchema.nullish(),
     /** URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl. */
     url: z.array(z.string()).max(10).optional(),
 });
 /**
- * The company or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.
+ * The company, Product, Service, or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.
  *
  * @openapiSchema IdentificationSubject
  * @endpoint POST /v1/entities/lookup

package/package.json

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