@aventurevc/api-schemas 0.8.348 → 0.8.350

package/dist/enrichment/batch.d.ts

@@ -1,6 +1,19 @@
 import { z } from "zod/v4";
 declare const EnrichmentBatchSchemaDefinition: z.ZodObject<{
     entityId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    instruction: z.ZodOptional<z.ZodArray<z.ZodType<{
+        record: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        userPrompt?: string | null | undefined;
+    }, import("./instruction.ts").EnrichmentInstructionSchemaInput, z.core.$ZodTypeInternals<{
+        record: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        userPrompt?: string | null | undefined;
+    }, import("./instruction.ts").EnrichmentInstructionSchemaInput>>>>;
     mode: z.ZodOptional<z.ZodEnum<{
         COMPREHENSIVE: "COMPREHENSIVE";
         INDIVIDUAL: "INDIVIDUAL";
@@ -15,7 +28,7 @@ type EnrichmentBatchDefinition = z.infer<typeof EnrichmentBatchSchemaDefinition>
 export interface EnrichmentBatchSchemaInput extends z.input<typeof EnrichmentBatchSchemaDefinition> {
 }
 /**
- * Existing records to enrich in one call, with the run options every run shares
+ * Existing records to enrich in one call, with shared run options and optional additional instructions for individual selected records
  *
  * @openapiSchema EnrichmentBatch
  * @endpoint POST /v1/enrichments

package/dist/enrichment/batch.js

@@ -1,9 +1,12 @@
 // 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 { EnrichmentInstructionSchema } from "./instruction.js";
 import { EnrichmentModeSchema } from "./mode.js";
 const EnrichmentBatchSchemaDefinition = z.object({
     /** Canonical entity UUIDs to enrich, filed in order before any person */
     entityId: z.array(z.uuid()).optional(),
+    /** Additional instructions for selected records, one entry per owner. Each entry appends to the shared userPrompt for that owner only. Duplicate or unselected owners and combined prompts longer than the run limit are rejected before any run is filed. Omit for identical instructions on every run. */
+    instruction: z.array(EnrichmentInstructionSchema).optional(),
     /** COMPREHENSIVE (the default) researches each whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey */
     mode: EnrichmentModeSchema.optional(),
     /** Model id for each run's lead agent; omit to use aVenture's default model */
@@ -18,7 +21,7 @@ const EnrichmentBatchSchemaDefinition = z.object({
     userPrompt: z.string().max(2000).nullish(),
 });
 /**
- * Existing records to enrich in one call, with the run options every run shares
+ * Existing records to enrich in one call, with shared run options and optional additional instructions for individual selected records
  *
  * @openapiSchema EnrichmentBatch
  * @endpoint POST /v1/enrichments

package/dist/enrichment/instruction.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+declare const EnrichmentInstructionSchemaDefinition: z.ZodObject<{
+    record: z.ZodObject<{
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>;
+    userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type EnrichmentInstructionDefinition = z.infer<typeof EnrichmentInstructionSchemaDefinition>;
+export interface EnrichmentInstructionSchemaInput extends z.input<typeof EnrichmentInstructionSchemaDefinition> {
+}
+/**
+ * Instructions appended to the shared userPrompt for exactly one selected record
+ *
+ * @openapiSchema EnrichmentInstruction
+ * @endpoint POST /v1/enrichments
+ * @usedBySchema EnrichmentBatchSchema
+ * @contractShape enrichment.instruction
+ * @contractRole canonical
+ */
+export declare const EnrichmentInstructionSchema: z.ZodType<EnrichmentInstructionDefinition, EnrichmentInstructionSchemaInput>;
+export type EnrichmentInstruction = z.infer<typeof EnrichmentInstructionSchema>;
+export {};
+//# sourceMappingURL=instruction.d.ts.map

package/dist/enrichment/instruction.js

@@ -0,0 +1,20 @@
+// 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 EnrichmentInstructionSchemaDefinition = z.object({
+    /** Selected company or person these instructions apply to */
+    record: EntityPersonOwnerSchema,
+    /** Additional instructions for this record only; shared and additional instructions together, separated by a blank line, must fit the run's userPrompt limit */
+    userPrompt: z.string().max(2000).nullish(),
+});
+/**
+ * Instructions appended to the shared userPrompt for exactly one selected record
+ *
+ * @openapiSchema EnrichmentInstruction
+ * @endpoint POST /v1/enrichments
+ * @usedBySchema EnrichmentBatchSchema
+ * @contractShape enrichment.instruction
+ * @contractRole canonical
+ */
+export const EnrichmentInstructionSchema = EnrichmentInstructionSchemaDefinition;
+//# sourceMappingURL=instruction.js.map

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

@@ -7,6 +7,7 @@ import { z } from "zod/v4";
  * @usedBySchema AddressLinkSchema
  * @usedBySchema BlogPostSchema
  * @usedBySchema ContactDetailSchema
+ * @usedBySchema EnrichmentInstructionSchema
  * @usedBySchema EnrichmentSchema
  * @usedBySchema EntityFundraiseInvestorJoinSchema
  * @usedBySchema EntityTextSchema

package/dist/entity/person-owner.js

@@ -8,6 +8,7 @@ import { z } from "zod/v4";
  * @usedBySchema AddressLinkSchema
  * @usedBySchema BlogPostSchema
  * @usedBySchema ContactDetailSchema
+ * @usedBySchema EnrichmentInstructionSchema
  * @usedBySchema EnrichmentSchema
  * @usedBySchema EntityFundraiseInvestorJoinSchema
  * @usedBySchema EntityTextSchema

package/dist/http/status-code.d.ts

@@ -25,6 +25,7 @@ export declare const HTTP_METHOD_NOT_ALLOWED: 405;
 export declare const HTTP_CONFLICT: 409;
 export declare const HTTP_GONE: 410;
 export declare const HTTP_UNPROCESSABLE_ENTITY: 422;
+export declare const HTTP_FAILED_DEPENDENCY: 424;
 export declare const HTTP_TOO_MANY_REQUESTS: 429;
 export declare const HTTP_INTERNAL_SERVER_ERROR: 500;
 export declare const HTTP_NOT_IMPLEMENTED: 501;

package/dist/http/status-code.js

@@ -26,6 +26,7 @@ export const HTTP_METHOD_NOT_ALLOWED = 405;
 export const HTTP_CONFLICT = 409;
 export const HTTP_GONE = 410;
 export const HTTP_UNPROCESSABLE_ENTITY = 422;
+export const HTTP_FAILED_DEPENDENCY = 424;
 export const HTTP_TOO_MANY_REQUESTS = 429;
 export const HTTP_INTERNAL_SERVER_ERROR = 500;
 export const HTTP_NOT_IMPLEMENTED = 501;

package/dist/openapi-component-manifest.js

@@ -290,6 +290,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     },
     Enrichment: { modulePath: "enrichment/enrichment", schemaName: "EnrichmentSchema" },
     EnrichmentBatch: { modulePath: "enrichment/batch", schemaName: "EnrichmentBatchSchema" },
+    EnrichmentInstruction: {
+        modulePath: "enrichment/instruction",
+        schemaName: "EnrichmentInstructionSchema",
+    },
     EnrichmentMode: { modulePath: "enrichment/mode", schemaName: "EnrichmentModeSchema" },
     EnrichmentPrompt: { modulePath: "enrichment/prompt", schemaName: "EnrichmentPromptSchema" },
     EnrichmentRefusalType: {

package/dist/problem/type.d.ts

@@ -68,6 +68,7 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     readonly NON_ENGLISH_ARTICLE: "https://api.aventure.vc/errors/non-english-article";
     readonly INVALID_IMAGE: "https://api.aventure.vc/errors/invalid-image";
     readonly UPSTREAM_EDGE_CHALLENGED: "https://api.aventure.vc/errors/upstream-edge-challenged";
+    readonly UPSTREAM_TARGET_THROTTLED: "https://api.aventure.vc/errors/upstream-target-throttled";
     readonly ACCELERATOR_DETAIL_RESTATES_TARGET: "https://api.aventure.vc/errors/accelerator-detail-restates-target";
 }>, z.ZodString]> & {
     enum: {
@@ -130,6 +131,7 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         readonly NON_ENGLISH_ARTICLE: "https://api.aventure.vc/errors/non-english-article";
         readonly INVALID_IMAGE: "https://api.aventure.vc/errors/invalid-image";
         readonly UPSTREAM_EDGE_CHALLENGED: "https://api.aventure.vc/errors/upstream-edge-challenged";
+        readonly UPSTREAM_TARGET_THROTTLED: "https://api.aventure.vc/errors/upstream-target-throttled";
         readonly ACCELERATOR_DETAIL_RESTATES_TARGET: "https://api.aventure.vc/errors/accelerator-detail-restates-target";
     };
 };

package/dist/problem/type.js

@@ -60,6 +60,7 @@ const ProblemTypeSchemaKnownMembers = z.enum({
     NON_ENGLISH_ARTICLE: "https://api.aventure.vc/errors/non-english-article",
     INVALID_IMAGE: "https://api.aventure.vc/errors/invalid-image",
     UPSTREAM_EDGE_CHALLENGED: "https://api.aventure.vc/errors/upstream-edge-challenged",
+    UPSTREAM_TARGET_THROTTLED: "https://api.aventure.vc/errors/upstream-target-throttled",
     ACCELERATOR_DETAIL_RESTATES_TARGET: "https://api.aventure.vc/errors/accelerator-detail-restates-target",
 });
 /**

package/package.json

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