@aventurevc/api-schemas 0.8.349 → 0.8.351

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/enrichment.d.ts

@@ -47,11 +47,15 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
         iteration: z.ZodInt;
         lane: z.ZodUnion<readonly [z.ZodEnum<{
             background: "background";
+            bulk: "bulk";
             interactive: "interactive";
+            live: "live";
         }>, z.ZodString]> & {
             enum: {
                 background: "background";
+                bulk: "bulk";
                 interactive: "interactive";
+                live: "live";
             };
         };
         latestStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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/harness/run-detail.d.ts

@@ -196,11 +196,15 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
         iteration: z.ZodInt;
         lane: z.ZodUnion<readonly [z.ZodEnum<{
             background: "background";
+            bulk: "bulk";
             interactive: "interactive";
+            live: "live";
         }>, z.ZodString]> & {
             enum: {
                 background: "background";
+                bulk: "bulk";
                 interactive: "interactive";
+                live: "live";
             };
         };
         latestStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/harness/run-lane.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Queue lane for admission priority: interactive client work vs background backlog
+ * Queue lane for admission priority: live (search and lookup) and interactive (one client run) take interactive admission; bulk (client batch) and background (system backlog) take background admission
  *
  * @openapiSchema HarnessRunLane
  * @endpoint GET /v1/research-runs
@@ -18,11 +18,15 @@ import { z } from "zod/v4";
  */
 export declare const HarnessRunLaneSchema: z.ZodUnion<readonly [z.ZodEnum<{
     background: "background";
+    bulk: "bulk";
     interactive: "interactive";
+    live: "live";
 }>, z.ZodString]> & {
     enum: {
         background: "background";
+        bulk: "bulk";
         interactive: "interactive";
+        live: "live";
     };
 };
 export type HarnessRunLane = z.infer<typeof HarnessRunLaneSchema>;

package/dist/harness/run-lane.js

@@ -1,8 +1,8 @@
 // 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 HarnessRunLaneSchemaKnownMembers = z.enum(["interactive", "background"]);
+const HarnessRunLaneSchemaKnownMembers = z.enum(["live", "interactive", "bulk", "background"]);
 /**
- * Queue lane for admission priority: interactive client work vs background backlog
+ * Queue lane for admission priority: live (search and lookup) and interactive (one client run) take interactive admission; bulk (client batch) and background (system backlog) take background admission
  *
  * @openapiSchema HarnessRunLane
  * @endpoint GET /v1/research-runs

package/dist/harness/run.d.ts

@@ -48,11 +48,15 @@ export declare const HarnessRunSchema: z.ZodObject<{
     iteration: z.ZodInt;
     lane: z.ZodUnion<readonly [z.ZodEnum<{
         background: "background";
+        bulk: "bulk";
         interactive: "interactive";
+        live: "live";
     }>, z.ZodString]> & {
         enum: {
             background: "background";
+            bulk: "bulk";
             interactive: "interactive";
+            live: "live";
         };
     };
     latestStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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/pagination/schemas.d.ts

@@ -12964,11 +12964,15 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
         iteration: z.ZodInt;
         lane: z.ZodUnion<readonly [z.ZodEnum<{
             background: "background";
+            bulk: "bulk";
             interactive: "interactive";
+            live: "live";
         }>, z.ZodString]> & {
             enum: {
                 background: "background";
+                bulk: "bulk";
                 interactive: "interactive";
+                live: "live";
             };
         };
         latestStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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/dist/unique/id-type.d.ts

@@ -30,6 +30,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     duns: "duns";
     ein: "ein";
     fdicCert: "fdicCert";
+    federalAgencyCode: "federalAgencyCode";
     firmCrd: "firmCrd";
     folk: "folk";
     holdingCompanyRssd: "holdingCompanyRssd";
@@ -44,6 +45,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     npi: "npi";
     orcid: "orcid";
     rssd: "rssd";
+    samUei: "samUei";
     secCik: "secCik";
     secPrivateFundId: "secPrivateFundId";
     signalNfxCompany: "signalNfxCompany";
@@ -58,6 +60,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         duns: "duns";
         ein: "ein";
         fdicCert: "fdicCert";
+        federalAgencyCode: "federalAgencyCode";
         firmCrd: "firmCrd";
         folk: "folk";
         holdingCompanyRssd: "holdingCompanyRssd";
@@ -72,6 +75,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         npi: "npi";
         orcid: "orcid";
         rssd: "rssd";
+        samUei: "samUei";
         secCik: "secCik";
         secPrivateFundId: "secPrivateFundId";
         signalNfxCompany: "signalNfxCompany";

package/dist/unique/id-type.js

@@ -23,6 +23,8 @@ const UniqueIdTypeSchemaKnownMembers = z.enum([
     "rssd",
     "holdingCompanyRssd",
     "naicCompanyCode",
+    "samUei",
+    "federalAgencyCode",
     "signalNfxFirm",
     "signalNfxPerson",
     "signalNfxCompany",

package/dist/unique/id.d.ts

@@ -11,6 +11,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
         duns: "duns";
         ein: "ein";
         fdicCert: "fdicCert";
+        federalAgencyCode: "federalAgencyCode";
         firmCrd: "firmCrd";
         folk: "folk";
         holdingCompanyRssd: "holdingCompanyRssd";
@@ -25,6 +26,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
         npi: "npi";
         orcid: "orcid";
         rssd: "rssd";
+        samUei: "samUei";
         secCik: "secCik";
         secPrivateFundId: "secPrivateFundId";
         signalNfxCompany: "signalNfxCompany";
@@ -39,6 +41,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
             duns: "duns";
             ein: "ein";
             fdicCert: "fdicCert";
+            federalAgencyCode: "federalAgencyCode";
             firmCrd: "firmCrd";
             folk: "folk";
             holdingCompanyRssd: "holdingCompanyRssd";
@@ -53,6 +56,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
             npi: "npi";
             orcid: "orcid";
             rssd: "rssd";
+            samUei: "samUei";
             secCik: "secCik";
             secPrivateFundId: "secPrivateFundId";
             signalNfxCompany: "signalNfxCompany";

package/package.json

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