@aventurevc/api-schemas 0.8.196 → 0.8.198

package/dist/address/address.js

@@ -50,7 +50,9 @@ import { AddressStateSchema } from "./state.js";
 export const AddressSchema = z.object({
     /** Legacy address row identifier */
     address: z.int().nullish(),
+    /** Canonical street address line. */
     addressLine1: z.string().nullish(),
+    /** Canonical suite, floor, or secondary address line. */
     addressLine2: z.string().nullish(),
     /** Role-period associations for this physical address */
     association: z.array(AddressAssociationSchema).optional(),
@@ -72,9 +74,11 @@ export const AddressSchema = z.object({
     isPrimary: z.boolean().nullish(),
     latitude: z.number().nullish(),
     longitude: z.number().nullish(),
+    /** Canonical postal or ZIP code. */
     postalCode: z.string().nullish(),
     /** State or region reference */
     state: AddressStateSchema.nullish(),
+    /** Canonical state or region abbreviation. */
     stateAbbrev: z.string().nullish(),
     street: z.string().nullish(),
     updatedAt: z.iso.datetime({ offset: true }).nullish(),

package/dist/enrichment/enrichment.d.ts

@@ -35,6 +35,12 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        followUpAdmission: z.ZodOptional<z.ZodEnum<{
+            PENDING: "PENDING";
+            REJECTED: "REJECTED";
+            SETTLED: "SETTLED";
+            UNTRACKED: "UNTRACKED";
+        }>>;
         hasSourceDocument: z.ZodBoolean;
         id: z.ZodUUID;
         iteration: z.ZodInt;

package/dist/entity/type.d.ts

@@ -12,6 +12,7 @@ import { z } from "zod/v4";
  * @usedBySchema IdentificationSubjectSchema
  * @usedBySchema NewsResolvedEntityLinkSchema
  * @usedBySchema PersonListArrayFilterSchema
+ * @usedBySchema ResearchSnippetTypeSchema
  * @usedBySchema SearchDuplicateCandidateScoreSchema
  * @contractShape entity.type
  * @contractRole canonical

package/dist/entity/type.js

@@ -13,6 +13,7 @@ import { z } from "zod/v4";
  * @usedBySchema IdentificationSubjectSchema
  * @usedBySchema NewsResolvedEntityLinkSchema
  * @usedBySchema PersonListArrayFilterSchema
+ * @usedBySchema ResearchSnippetTypeSchema
  * @usedBySchema SearchDuplicateCandidateScoreSchema
  * @contractShape entity.type
  * @contractRole canonical

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

@@ -50,6 +50,16 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
         }>;
         updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     }, z.core.$strip>>>;
+    followUp: z.ZodOptional<z.ZodObject<{
+        admission: z.ZodEnum<{
+            PENDING: "PENDING";
+            REJECTED: "REJECTED";
+            SETTLED: "SETTLED";
+            UNTRACKED: "UNTRACKED";
+        }>;
+        hasMore: z.ZodBoolean;
+        runId: z.ZodArray<z.ZodUUID>;
+    }, z.core.$strip>>;
     latestStatus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         complete: z.ZodBoolean;
         entitySlug: z.ZodNullable<z.ZodString>;
@@ -127,6 +137,12 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        followUpAdmission: z.ZodOptional<z.ZodEnum<{
+            PENDING: "PENDING";
+            REJECTED: "REJECTED";
+            SETTLED: "SETTLED";
+            UNTRACKED: "UNTRACKED";
+        }>>;
         hasSourceDocument: z.ZodBoolean;
         id: z.ZodUUID;
         iteration: z.ZodInt;

package/dist/harness/run-detail.js

@@ -1,11 +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";
 import { EntitySchema } from "../entity/entity.js";
+import { HarnessRunFollowUpSchema } from "./run-follow-up.js";
 import { HarnessRunProgressSchema } from "./run-progress.js";
 import { HarnessRunSchema } from "./run.js";
 const HarnessRunDetailSchemaDefinition = z.object({
     /** Current public profile the run resolved to */
     entity: EntitySchema.nullish(),
+    /** Follow-up admission and direct child run ids for this terminal generation */
+    followUp: HarnessRunFollowUpSchema.optional(),
     /** Latest research progress; null when none is available */
     latestStatus: HarnessRunProgressSchema.nullish(),
     /** Parent organization's core record when the resolved entity is a Product/Service; null for every other entity type */

package/dist/harness/run-follow-up-admission.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v4";
+/**
+ * Durable admission state for one terminal run generation's follow-up work
+ *
+ * @openapiSchema HarnessRunFollowUpAdmission
+ * @endpoint GET /v1/research-runs/{runId}
+ * @endpoint POST /v1/enrichments
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @endpoint POST /v1/research-runs
+ * @usedBySchema HarnessRunFollowUpSchema
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-follow-up-admission
+ * @contractRole canonical
+ */
+export declare const HarnessRunFollowUpAdmissionSchema: z.ZodEnum<{
+    PENDING: "PENDING";
+    REJECTED: "REJECTED";
+    SETTLED: "SETTLED";
+    UNTRACKED: "UNTRACKED";
+}>;
+export type HarnessRunFollowUpAdmission = z.infer<typeof HarnessRunFollowUpAdmissionSchema>;
+//# sourceMappingURL=run-follow-up-admission.d.ts.map

package/dist/harness/run-follow-up-admission.js

@@ -0,0 +1,23 @@
+// 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";
+/**
+ * Durable admission state for one terminal run generation's follow-up work
+ *
+ * @openapiSchema HarnessRunFollowUpAdmission
+ * @endpoint GET /v1/research-runs/{runId}
+ * @endpoint POST /v1/enrichments
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/people/{personId}/enrichments
+ * @endpoint POST /v1/research-runs
+ * @usedBySchema HarnessRunFollowUpSchema
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-follow-up-admission
+ * @contractRole canonical
+ */
+export const HarnessRunFollowUpAdmissionSchema = z.enum([
+    "UNTRACKED",
+    "PENDING",
+    "SETTLED",
+    "REJECTED",
+]);
+//# sourceMappingURL=run-follow-up-admission.js.map

package/dist/harness/run-follow-up.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+/**
+ * Durable completion barrier and direct child run ids
+ *
+ * @openapiSchema HarnessRunFollowUp
+ * @endpoint GET /v1/research-runs/{runId}
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape harness.run-follow-up
+ * @contractRole canonical
+ */
+export declare const HarnessRunFollowUpSchema: z.ZodObject<{
+    admission: z.ZodEnum<{
+        PENDING: "PENDING";
+        REJECTED: "REJECTED";
+        SETTLED: "SETTLED";
+        UNTRACKED: "UNTRACKED";
+    }>;
+    hasMore: z.ZodBoolean;
+    runId: z.ZodArray<z.ZodUUID>;
+}, z.core.$strip>;
+export type HarnessRunFollowUp = z.infer<typeof HarnessRunFollowUpSchema>;
+//# sourceMappingURL=run-follow-up.d.ts.map

package/dist/harness/run-follow-up.js

@@ -0,0 +1,21 @@
+// 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 { HarnessRunFollowUpAdmissionSchema } from "./run-follow-up-admission.js";
+/**
+ * Durable completion barrier and direct child run ids
+ *
+ * @openapiSchema HarnessRunFollowUp
+ * @endpoint GET /v1/research-runs/{runId}
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape harness.run-follow-up
+ * @contractRole canonical
+ */
+export const HarnessRunFollowUpSchema = z.object({
+    /** PENDING until every follow-up admission is durable; REJECTED when the bounded redo is exhausted */
+    admission: HarnessRunFollowUpAdmissionSchema,
+    /** More than the bounded child count exists; completion is unproven */
+    hasMore: z.boolean(),
+    /** Direct appointed run ids; read each run's detail recursively */
+    runId: z.array(z.uuid()),
+});
+//# sourceMappingURL=run-follow-up.js.map

package/dist/harness/run.d.ts

@@ -31,6 +31,12 @@ export declare const HarnessRunSchema: z.ZodObject<{
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    followUpAdmission: z.ZodOptional<z.ZodEnum<{
+        PENDING: "PENDING";
+        REJECTED: "REJECTED";
+        SETTLED: "SETTLED";
+        UNTRACKED: "UNTRACKED";
+    }>>;
     hasSourceDocument: z.ZodBoolean;
     id: z.ZodUUID;
     iteration: z.ZodInt;

package/dist/harness/run.js

@@ -4,6 +4,7 @@ import { EnrichmentModeSchema } from "../enrichment/mode.js";
 import { HarnessChassisSchema } from "./chassis.js";
 import { HarnessLlmApiSchema } from "./llm-api.js";
 import { HarnessRunEnvironmentSchema } from "./run-environment.js";
+import { HarnessRunFollowUpAdmissionSchema } from "./run-follow-up-admission.js";
 import { HarnessRunLaneSchema } from "./run-lane.js";
 import { HarnessRunStatusSchema } from "./run-status.js";
 import { HarnessRunTypeSchema } from "./run-type.js";
@@ -41,6 +42,8 @@ export const HarnessRunSchema = z.object({
     failureClass: z.string().nullish(),
     /** Run completion timestamp */
     finishedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Follow-up admission for the exact current terminal generation; old engine terminals remain PENDING */
+    followUpAdmission: HarnessRunFollowUpAdmissionSchema.optional(),
     /** Whether this run consumes an immutable private source document */
     hasSourceDocument: z.boolean(),
     /** Run id */

package/dist/harness/task-plan.js

@@ -17,7 +17,7 @@ export const HarnessTaskPlanSchema = z.object({
     catalogRevision: z.int().optional(),
     /** Canonical completion gate ids this task is responsible for; the ids resolve through the completion contract catalog. */
     gateId: z.array(z.string()).optional(),
-    /** Typed inputs the task needs before it runs. */
+    /** Typed task inputs; required inputs must be bound before it runs. */
     input: z.array(HarnessTaskSchema),
     /** Steps in run order; an empty list means this catalog task is unplanned. */
     step: z.array(HarnessTaskPlanStepSchema),

package/dist/media/upload.d.ts

@@ -37,6 +37,7 @@ declare const MediaUploadSchemaDefinition: z.ZodObject<{
         PERSON: "PERSON";
     }>;
     path: z.ZodString;
+    squareOriginalValidated: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     targetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type MediaUploadDefinition = z.infer<typeof MediaUploadSchemaDefinition>;

package/dist/media/upload.js

@@ -13,6 +13,8 @@ const MediaUploadSchemaDefinition = z.object({
     mediaType: MediaObjectTypeSchema,
     /** Attached managed storage path; never an external image URL */
     path: z.string(),
+    /** True only when this read fetched and validated the stored entity SQUARE original; absent on ordinary metadata reads and other media slots. */
+    squareOriginalValidated: z.boolean().nullish(),
     /** Attached entity/person/news target id, when known */
     targetId: z.string().nullish(),
 });

package/dist/openapi-component-manifest.js

@@ -556,6 +556,14 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "harness/run-environment",
         schemaName: "HarnessRunEnvironmentSchema",
     },
+    HarnessRunFollowUp: {
+        modulePath: "harness/run-follow-up",
+        schemaName: "HarnessRunFollowUpSchema",
+    },
+    HarnessRunFollowUpAdmission: {
+        modulePath: "harness/run-follow-up-admission",
+        schemaName: "HarnessRunFollowUpAdmissionSchema",
+    },
     HarnessRunLane: { modulePath: "harness/run-lane", schemaName: "HarnessRunLaneSchema" },
     HarnessRunProgress: {
         modulePath: "harness/run-progress",

package/dist/research/snippet-type.d.ts

@@ -2,6 +2,17 @@ import { z } from "zod/v4";
 declare const ResearchSnippetTypeSchemaDefinition: z.ZodObject<{
     analysisRenderable: z.ZodBoolean;
     analysisSectionLabel: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    appliesToType: z.ZodArray<z.ZodEnum<{
+        "Business Line": "Business Line";
+        Company: "Company";
+        Fund: "Fund";
+        Government: "Government";
+        "Investment Firm": "Investment Firm";
+        Nonprofit: "Nonprofit";
+        Organization: "Organization";
+        Product: "Product";
+        Service: "Service";
+    }>>;
     curated: z.ZodBoolean;
     defaultVisible: z.ZodBoolean;
     label: z.ZodString;

package/dist/research/snippet-type.js

@@ -1,11 +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";
+import { EntityTypeSchema } from "../entity/type.js";
 import { ResearchParagraphShapeSchema } from "./paragraph-shape.js";
 const ResearchSnippetTypeSchemaDefinition = z.object({
     /** Whether curated rows of this snippet type can make the public company Analysis page eligible. */
     analysisRenderable: z.boolean(),
     /** Ordered headings for the fixed paragraphs of a framework analysis. Empty means ordinary prose; preserve legacy prose when its paragraph count differs. */
     analysisSectionLabel: z.array(z.string()).optional(),
+    /** Entity types for which this snippet is meaningful; empty means every type. */
+    appliesToType: z.array(EntityTypeSchema),
     /** Whether the type is curated; with analysisRenderable this gates public Analysis-page eligibility. It does not gate snippet display — every type listed here is recognized and defaults to visible, and the row-level visible flag controls display. */
     curated: z.boolean(),
     /** Default visible flag when a write omits visible; true for recognized snippet types even when curated=false. */

package/package.json

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