@aventurevc/api-schemas 0.8.33 → 0.8.35

package/dist/enrichment/batch.js

@@ -13,7 +13,7 @@ const EnrichmentBatchSchemaDefinition = z.object({
     /** 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 */
     taskPresetKey: z.array(z.string()).nullish(),
     /** Plain-language instruction for every run, such as which facts or sources to check first */
-    userPrompt: z.string().nullish(),
+    userPrompt: z.string().max(2000).nullish(),
 });
 /**
  * Existing records to enrich in one call, with the run options every run shares

package/dist/enrichment/prompt.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+declare const EnrichmentPromptSchemaDefinition: z.ZodObject<{
+    userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type EnrichmentPromptDefinition = z.infer<typeof EnrichmentPromptSchemaDefinition>;
+/**
+ * Optional steering for one company or person enrichment run
+ *
+ * @openapiSchema EnrichmentPrompt
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @contractShape enrichment.prompt
+ * @contractRole canonical
+ */
+export declare const EnrichmentPromptSchema: z.ZodType<EnrichmentPromptDefinition>;
+export type EnrichmentPrompt = z.infer<typeof EnrichmentPromptSchema>;
+export {};
+//# sourceMappingURL=prompt.d.ts.map

package/dist/enrichment/prompt.js

@@ -0,0 +1,17 @@
+// 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 EnrichmentPromptSchemaDefinition = z.object({
+    /** Plain-language instruction for this run, such as which facts or sources to check first */
+    userPrompt: z.string().max(2000).nullish(),
+});
+/**
+ * Optional steering for one company or person enrichment run
+ *
+ * @openapiSchema EnrichmentPrompt
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @contractShape enrichment.prompt
+ * @contractRole canonical
+ */
+export const EnrichmentPromptSchema = EnrichmentPromptSchemaDefinition;
+//# sourceMappingURL=prompt.js.map

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. Invalid for a person lookup. */
+    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/dist/openapi-component-manifest.js

@@ -198,6 +198,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     Enrichment: { modulePath: "enrichment/enrichment", schemaName: "EnrichmentSchema" },
     EnrichmentBatch: { modulePath: "enrichment/batch", schemaName: "EnrichmentBatchSchema" },
     EnrichmentMode: { modulePath: "enrichment/mode", schemaName: "EnrichmentModeSchema" },
+    EnrichmentPrompt: { modulePath: "enrichment/prompt", schemaName: "EnrichmentPromptSchema" },
     EnrichmentRefusalType: {
         modulePath: "enrichment/refusal-type",
         schemaName: "EnrichmentRefusalTypeSchema",

package/dist/system/status.d.ts

@@ -1,7 +1,13 @@
 import { z } from "zod/v4";
 declare const SystemStatusSchemaDefinition: z.ZodObject<{
+    latestIosBuild: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    latestIosVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    latestMacosBuild: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    latestMacosVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     minimumIosBuild: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     minimumIosVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    minimumMacosBuild: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    minimumMacosVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     operationFingerprint: z.ZodString;
     uptime: z.ZodType<{
         availability?: number | null | undefined;
@@ -17,7 +23,7 @@ declare const SystemStatusSchemaDefinition: z.ZodObject<{
 }, z.core.$strip>;
 type SystemStatusDefinition = z.infer<typeof SystemStatusSchemaDefinition>;
 /**
- * Uptime SLA, served-operation identity, and minimum supported iOS build
+ * Uptime SLA, served-operation identity, and Apple app update policy
  *
  * @openapiSchema SystemStatus
  * @endpoint GET /v1/status

package/dist/system/status.js

@@ -2,17 +2,29 @@
 import { z } from "zod/v4";
 import { UptimeSchema } from "../uptime/uptime.js";
 const SystemStatusSchemaDefinition = z.object({
+    /** Latest available App Store iOS build number within that version */
+    latestIosBuild: z.int().nullish(),
+    /** Latest available App Store iOS marketing version; empty disables the optional update prompt */
+    latestIosVersion: z.string().nullish(),
+    /** Latest available App Store macOS build number within that version */
+    latestMacosBuild: z.int().nullish(),
+    /** Latest available App Store macOS marketing version; empty disables the optional update prompt */
+    latestMacosVersion: z.string().nullish(),
     /** Minimum supported App Store iOS build number within the minimum version */
     minimumIosBuild: z.int().nullish(),
     /** Minimum supported App Store iOS marketing version; empty disables update enforcement */
     minimumIosVersion: z.string().nullish(),
+    /** Minimum supported App Store macOS build number within that version */
+    minimumMacosBuild: z.int().nullish(),
+    /** Minimum supported App Store macOS marketing version; empty disables update enforcement */
+    minimumMacosVersion: z.string().nullish(),
     /** Short hash identifying the exact set of operations this deployment serves. A generated client stamps the same value from the OpenAPI document it was built from; an unequal value means the client catalog is stale. `vc.aventure.application.usecase.system.status.OperationInventory` owns how it is computed. */
     operationFingerprint: z.string(),
     /** Uptime SLA data from external uptime monitoring */
     uptime: UptimeSchema,
 });
 /**
- * Uptime SLA, served-operation identity, and minimum supported iOS build
+ * Uptime SLA, served-operation identity, and Apple app update policy
  *
  * @openapiSchema SystemStatus
  * @endpoint GET /v1/status

package/package.json

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