@aventurevc/api-schemas 0.7.288 → 0.7.291

package/dist/enrichment/mode.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * Whether the run performs comprehensive enrichment or only selected tasks
+ *
+ * @openapiSchema EnrichmentMode
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape enrichment.mode
+ * @contractRole canonical
+ */
+export declare const EnrichmentModeSchema: z.ZodEnum<{
+    COMPREHENSIVE: "COMPREHENSIVE";
+    INDIVIDUAL: "INDIVIDUAL";
+}>;
+export type EnrichmentMode = z.infer<typeof EnrichmentModeSchema>;
+//# sourceMappingURL=mode.d.ts.map

package/dist/enrichment/mode.js

@@ -0,0 +1,14 @@
+// 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";
+/**
+ * Whether the run performs comprehensive enrichment or only selected tasks
+ *
+ * @openapiSchema EnrichmentMode
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape enrichment.mode
+ * @contractRole canonical
+ */
+export const EnrichmentModeSchema = z.enum(["COMPREHENSIVE", "INDIVIDUAL"]);
+//# sourceMappingURL=mode.js.map

package/dist/entity/filter-search.d.ts

@@ -111,6 +111,7 @@ declare const EntityFilterSearchSchemaDefinition: z.ZodObject<{
         }, z.core.$strip>>;
         mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
         operatingStatus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        person: z.ZodOptional<z.ZodArray<z.ZodString>>;
         portfolioHeadquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
         portfolioHeadquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
         portfolioHeadquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/entity/filter.d.ts

@@ -120,6 +120,7 @@ export declare const EntityFilterSchema: z.ZodObject<{
     }, z.core.$strip>>;
     mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
     operatingStatus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    person: z.ZodOptional<z.ZodArray<z.ZodString>>;
     portfolioHeadquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
     portfolioHeadquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
     portfolioHeadquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/entity/filter.js

@@ -61,6 +61,8 @@ export const EntityFilterSchema = z.strictObject({
     mainProduct: z.array(z.string()).optional(),
     /** Operating status values. */
     operatingStatus: z.array(z.string()).optional(),
+    /** Associated person, matched by name. */
+    person: z.array(z.string()).optional(),
     /** Portfolio-company headquarters city values. */
     portfolioHeadquartersCity: z.array(z.string()).optional(),
     /** Portfolio-company headquarters country values. */

package/dist/entity/list-filter.d.ts

@@ -107,6 +107,7 @@ declare const EntityListFilterSchemaDefinition: z.ZodObject<{
     }, z.core.$strip>>;
     mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
     operatingStatus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    person: z.ZodOptional<z.ZodArray<z.ZodString>>;
     portfolioHeadquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
     portfolioHeadquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
     portfolioHeadquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/entity/list-filter.js

@@ -48,6 +48,8 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     mainProduct: z.array(z.string()).optional(),
     /** Operating status values. */
     operatingStatus: z.array(z.string()).optional(),
+    /** Associated person, matched by name. */
+    person: z.array(z.string()).optional(),
     /** Portfolio-company headquarters city values. */
     portfolioHeadquartersCity: z.array(z.string()).optional(),
     /** Portfolio-company headquarters country values. */

package/dist/entity/natural-search.d.ts

@@ -108,6 +108,7 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
         }, z.core.$strip>>;
         mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
         operatingStatus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        person: z.ZodOptional<z.ZodArray<z.ZodString>>;
         portfolioHeadquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
         portfolioHeadquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
         portfolioHeadquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/federated/search.d.ts

@@ -79,6 +79,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 } | undefined;
                 mainProduct?: string[] | undefined;
                 operatingStatus?: string[] | undefined;
+                person?: string[] | undefined;
                 portfolioHeadquartersCity?: string[] | undefined;
                 portfolioHeadquartersCountry?: string[] | undefined;
                 portfolioHeadquartersState?: string[] | undefined;
@@ -673,6 +674,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 } | undefined;
                 mainProduct?: string[] | undefined;
                 operatingStatus?: string[] | undefined;
+                person?: string[] | undefined;
                 portfolioHeadquartersCity?: string[] | undefined;
                 portfolioHeadquartersCountry?: string[] | undefined;
                 portfolioHeadquartersState?: string[] | undefined;

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

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+/**
+ * Owning API environment
+ *
+ * @openapiSchema HarnessRunEnvironment
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-environment
+ * @contractRole canonical
+ */
+export declare const HarnessRunEnvironmentSchema: z.ZodEnum<{
+    development: "development";
+    production: "production";
+    staging: "staging";
+    unassigned: "unassigned";
+}>;
+export type HarnessRunEnvironment = z.infer<typeof HarnessRunEnvironmentSchema>;
+//# sourceMappingURL=run-environment.d.ts.map

package/dist/harness/run-environment.js

@@ -0,0 +1,19 @@
+// 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";
+/**
+ * Owning API environment
+ *
+ * @openapiSchema HarnessRunEnvironment
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-environment
+ * @contractRole canonical
+ */
+export const HarnessRunEnvironmentSchema = z.enum([
+    "unassigned",
+    "development",
+    "staging",
+    "production",
+]);
+//# sourceMappingURL=run-environment.js.map

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

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+/**
+ * Harness run lifecycle state
+ *
+ * @openapiSchema HarnessRunStatus
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-status
+ * @contractRole canonical
+ */
+export declare const HarnessRunStatusSchema: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    queued: "queued";
+    running: "running";
+    stopped: "stopped";
+}>;
+export type HarnessRunStatus = z.infer<typeof HarnessRunStatusSchema>;
+//# sourceMappingURL=run-status.d.ts.map

package/dist/harness/run-status.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";
+/**
+ * Harness run lifecycle state
+ *
+ * @openapiSchema HarnessRunStatus
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-status
+ * @contractRole canonical
+ */
+export const HarnessRunStatusSchema = z.enum([
+    "queued",
+    "running",
+    "completed",
+    "failed",
+    "stopped",
+]);
+//# sourceMappingURL=run-status.js.map

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

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * Harness run kind: full enrichment loop or bounded micro-task
+ *
+ * @openapiSchema HarnessRunType
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-type
+ * @contractRole canonical
+ */
+export declare const HarnessRunTypeSchema: z.ZodEnum<{
+    ENRICHMENT: "ENRICHMENT";
+    TASK: "TASK";
+}>;
+export type HarnessRunType = z.infer<typeof HarnessRunTypeSchema>;
+//# sourceMappingURL=run-type.d.ts.map

package/dist/harness/run-type.js

@@ -0,0 +1,14 @@
+// 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";
+/**
+ * Harness run kind: full enrichment loop or bounded micro-task
+ *
+ * @openapiSchema HarnessRunType
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-type
+ * @contractRole canonical
+ */
+export const HarnessRunTypeSchema = z.enum(["ENRICHMENT", "TASK"]);
+//# sourceMappingURL=run-type.js.map

package/dist/harness/run.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod/v4";
+declare const HarnessRunSchemaDefinition: z.ZodObject<{
+    attempt: z.ZodInt;
+    createdAt: z.ZodISODateTime;
+    entitySlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    environment: z.ZodEnum<{
+        development: "development";
+        production: "production";
+        staging: "staging";
+        unassigned: "unassigned";
+    }>;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    hasSourceDocument: z.ZodBoolean;
+    id: z.ZodUUID;
+    iteration: z.ZodInt;
+    latestStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxIteration: z.ZodInt;
+    maxScoutConcurrent: z.ZodInt;
+    mode: z.ZodEnum<{
+        COMPREHENSIVE: "COMPREHENSIVE";
+        INDIVIDUAL: "INDIVIDUAL";
+    }>;
+    model: z.ZodString;
+    nextAttemptAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    resumeSafeUntil: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    startedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        stopped: "stopped";
+    }>;
+    subagentModel: z.ZodString;
+    taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    type: z.ZodEnum<{
+        ENRICHMENT: "ENRICHMENT";
+        TASK: "TASK";
+    }>;
+    updatedAt: z.ZodISODateTime;
+    url: z.ZodString;
+    userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type HarnessRunDefinition = z.infer<typeof HarnessRunSchemaDefinition>;
+/**
+ * One harness enrichment run
+ *
+ * @openapiSchema HarnessRun
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @contractShape harness.run
+ * @contractRole canonical
+ */
+export declare const HarnessRunSchema: z.ZodType<HarnessRunDefinition>;
+export type HarnessRun = z.infer<typeof HarnessRunSchema>;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/harness/run.js

@@ -0,0 +1,69 @@
+// 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 { EnrichmentModeSchema } from "../enrichment/mode.js";
+import { HarnessRunEnvironmentSchema } from "./run-environment.js";
+import { HarnessRunStatusSchema } from "./run-status.js";
+import { HarnessRunTypeSchema } from "./run-type.js";
+const HarnessRunSchemaDefinition = z.object({
+    /** Retry attempt counter */
+    attempt: z.int(),
+    /** Creation timestamp */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** Canonical slug of the entity the run produced */
+    entitySlug: z.string().nullish(),
+    /** API environment */
+    environment: HarnessRunEnvironmentSchema,
+    /** Terminal failure reason, when failed */
+    error: z.string().nullish(),
+    /** Typed terminal-failure class from the harness retry classifier (e.g. runtime_cap, escalated, provider_capacity, context_overflow); null unless failed */
+    failureClass: z.string().nullish(),
+    /** Run completion timestamp */
+    finishedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Whether this run consumes an immutable private source document */
+    hasSourceDocument: z.boolean(),
+    /** Run id */
+    id: z.uuid(),
+    /** Current loop iteration */
+    iteration: z.int(),
+    /** Latest enrich-loop status as an opaque JSON string */
+    latestStatus: z.string().nullish(),
+    /** Loop iteration cap */
+    maxIteration: z.int(),
+    /** Parallel read-only scout fan-out width N */
+    maxScoutConcurrent: z.int(),
+    /** Enrichment breadth selected for this run */
+    mode: EnrichmentModeSchema,
+    /** Orchestrator model id */
+    model: z.string(),
+    /** Earliest re-claim time when waiting on retry backoff */
+    nextAttemptAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Instant past which a warm resume is no longer guaranteed; the harness writes it with session_resume from the model's cache window. Warm-resumable now iff failed/stopped and this is in the future. Null when there is no resume window. */
+    resumeSafeUntil: z.iso.datetime({ offset: true }).nullish(),
+    /** Run start timestamp */
+    startedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Current lifecycle state */
+    status: HarnessRunStatusSchema,
+    /** Read-only research, cohort, and completion sub-agent model id */
+    subagentModel: z.string(),
+    /** Selected task preset keys filed with the run */
+    taskPresetKey: z.array(z.string()).nullish(),
+    /** Run kind derived from task-key presence: ENRICHMENT for a client-submitted comprehensive or preset-scoped run, TASK for a platform-scheduled micro-task execution */
+    type: HarnessRunTypeSchema,
+    /** Last update timestamp */
+    updatedAt: z.iso.datetime({ offset: true }),
+    /** Company URL under enrichment */
+    url: z.string(),
+    /** Optional steering prompt filed with the run */
+    userPrompt: z.string().nullish(),
+});
+/**
+ * One harness enrichment run
+ *
+ * @openapiSchema HarnessRun
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @contractShape harness.run
+ * @contractRole canonical
+ */
+export const HarnessRunSchema = HarnessRunSchemaDefinition;
+//# sourceMappingURL=run.js.map

package/dist/link/search.d.ts

@@ -81,6 +81,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     } | undefined;
                     mainProduct?: string[] | undefined;
                     operatingStatus?: string[] | undefined;
+                    person?: string[] | undefined;
                     portfolioHeadquartersCity?: string[] | undefined;
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;
@@ -843,6 +844,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     } | undefined;
                     mainProduct?: string[] | undefined;
                     operatingStatus?: string[] | undefined;
+                    person?: string[] | undefined;
                     portfolioHeadquartersCity?: string[] | undefined;
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;

package/dist/natural/search-result.d.ts

@@ -78,6 +78,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             } | undefined;
             mainProduct?: string[] | undefined;
             operatingStatus?: string[] | undefined;
+            person?: string[] | undefined;
             portfolioHeadquartersCity?: string[] | undefined;
             portfolioHeadquartersCountry?: string[] | undefined;
             portfolioHeadquartersState?: string[] | undefined;
@@ -191,6 +192,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             } | undefined;
             mainProduct?: string[] | undefined;
             operatingStatus?: string[] | undefined;
+            person?: string[] | undefined;
             portfolioHeadquartersCity?: string[] | undefined;
             portfolioHeadquartersCountry?: string[] | undefined;
             portfolioHeadquartersState?: string[] | undefined;

package/dist/openapi-component-manifest.js

@@ -195,6 +195,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "DuplicateCreateReviewSchema",
     },
     EmployeeCount: { modulePath: "employee/count", schemaName: "EmployeeCountSchema" },
+    EnrichmentMode: { modulePath: "enrichment/mode", schemaName: "EnrichmentModeSchema" },
     Entity: { modulePath: "entity/entity", schemaName: "EntitySchema" },
     EntityAcceleratorParticipation: {
         modulePath: "entity/accelerator-participation",
@@ -479,6 +480,13 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "FundraiseTransactionStatusSchema",
     },
     GithubRepo: { modulePath: "github/repo", schemaName: "GithubRepoSchema" },
+    HarnessRun: { modulePath: "harness/run", schemaName: "HarnessRunSchema" },
+    HarnessRunEnvironment: {
+        modulePath: "harness/run-environment",
+        schemaName: "HarnessRunEnvironmentSchema",
+    },
+    HarnessRunStatus: { modulePath: "harness/run-status", schemaName: "HarnessRunStatusSchema" },
+    HarnessRunType: { modulePath: "harness/run-type", schemaName: "HarnessRunTypeSchema" },
     HelpCitation: { modulePath: "help/citation", schemaName: "HelpCitationSchema" },
     HelpScope: { modulePath: "help/scope", schemaName: "HelpScopeSchema" },
     HelpSourceType: { modulePath: "help/source-type", schemaName: "HelpSourceTypeSchema" },

package/dist/search/interpretation.d.ts

@@ -84,6 +84,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
         } | undefined;
         mainProduct?: string[] | undefined;
         operatingStatus?: string[] | undefined;
+        person?: string[] | undefined;
         portfolioHeadquartersCity?: string[] | undefined;
         portfolioHeadquartersCountry?: string[] | undefined;
         portfolioHeadquartersState?: string[] | undefined;
@@ -180,6 +181,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
         } | undefined;
         mainProduct?: string[] | undefined;
         operatingStatus?: string[] | undefined;
+        person?: string[] | undefined;
         portfolioHeadquartersCity?: string[] | undefined;
         portfolioHeadquartersCountry?: string[] | undefined;
         portfolioHeadquartersState?: string[] | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.7.288",
+  "version": "0.7.291",
   "private": false,
   "description": "Zod v4 schemas for the public aVenture API.",
   "license": "Apache-2.0",