@aventurevc/api-schemas 0.8.410 → 0.8.412

package/dist/enrichment/enrichment.d.ts

@@ -121,6 +121,22 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
         subagentModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        terminalDecision: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            engineId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            iteration: z.ZodInt;
+            lockedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            sequence: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                queued: "queued";
+                running: "running";
+                stopped: "stopped";
+            }>;
+            suppressionEntityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            suppressionProvenanceEventId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
         type: z.ZodEnum<{
             ENRICHMENT: "ENRICHMENT";
             TASK: "TASK";

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

@@ -279,6 +279,22 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
         subagentModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        terminalDecision: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            engineId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            iteration: z.ZodInt;
+            lockedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            sequence: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                queued: "queued";
+                running: "running";
+                stopped: "stopped";
+            }>;
+            suppressionEntityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            suppressionProvenanceEventId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
         type: z.ZodEnum<{
             ENRICHMENT: "ENRICHMENT";
             TASK: "TASK";

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

@@ -10,6 +10,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/people/{personId}/enrichments
  * @endpoint POST /v1/research/runs
  * @usedBySchema HarnessRunSchema
+ * @usedBySchema HarnessRunTerminalDecisionSchema
  * @contractShape harness.run-status
  * @contractRole canonical
  */

package/dist/harness/run-status.js

@@ -11,6 +11,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/people/{personId}/enrichments
  * @endpoint POST /v1/research/runs
  * @usedBySchema HarnessRunSchema
+ * @usedBySchema HarnessRunTerminalDecisionSchema
  * @contractShape harness.run-status
  * @contractRole canonical
  */

package/dist/harness/run-terminal-decision.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod/v4";
+/**
+ * Server admission for one terminal transition
+ *
+ * @openapiSchema HarnessRunTerminalDecision
+ * @endpoint GET /v1/research/runs
+ * @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 HarnessRunSchema
+ * @contractShape harness.run-terminal-decision
+ * @contractRole canonical
+ */
+export declare const HarnessRunTerminalDecisionSchema: z.ZodObject<{
+    engineId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    iteration: z.ZodInt;
+    lockedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    sequence: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        stopped: "stopped";
+    }>;
+    suppressionEntityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    suppressionProvenanceEventId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type HarnessRunTerminalDecision = z.infer<typeof HarnessRunTerminalDecisionSchema>;
+//# sourceMappingURL=run-terminal-decision.d.ts.map

package/dist/harness/run-terminal-decision.js

@@ -0,0 +1,36 @@
+// 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 { HarnessRunStatusSchema } from "./run-status.js";
+/**
+ * Server admission for one terminal transition
+ *
+ * @openapiSchema HarnessRunTerminalDecision
+ * @endpoint GET /v1/research/runs
+ * @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 HarnessRunSchema
+ * @contractShape harness.run-terminal-decision
+ * @contractRole canonical
+ */
+export const HarnessRunTerminalDecisionSchema = z.object({
+    /** Lease owner at the terminal transition */
+    engineId: z.string().nullish(),
+    /** Finish time accepted by the terminal transition */
+    finishedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Iteration accepted by the terminal transition */
+    iteration: z.int(),
+    /** Lease generation at the terminal transition */
+    lockedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Server event sequence on run reads; the event stream supplies it separately */
+    sequence: z.int().nullish(),
+    /** Admitted terminal status */
+    status: HarnessRunStatusSchema,
+    /** Accepted entity whose suppression admitted this finish */
+    suppressionEntityId: z.uuid().nullish(),
+    /** Canonical provenance event that admitted suppression */
+    suppressionProvenanceEventId: z.number().int().nullish(),
+});
+//# sourceMappingURL=run-terminal-decision.js.map

package/dist/harness/run.d.ts

@@ -119,6 +119,22 @@ export declare const HarnessRunSchema: z.ZodObject<{
     subagentModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    terminalDecision: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        engineId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        iteration: z.ZodInt;
+        lockedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        sequence: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            stopped: "stopped";
+        }>;
+        suppressionEntityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        suppressionProvenanceEventId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
     type: z.ZodEnum<{
         ENRICHMENT: "ENRICHMENT";
         TASK: "TASK";

package/dist/harness/run.js

@@ -9,6 +9,7 @@ import { HarnessRunExecutionSchema } from "./run-execution.js";
 import { HarnessRunFollowUpAdmissionSchema } from "./run-follow-up-admission.js";
 import { HarnessRunLaneSchema } from "./run-lane.js";
 import { HarnessRunStatusSchema } from "./run-status.js";
+import { HarnessRunTerminalDecisionSchema } from "./run-terminal-decision.js";
 import { HarnessRunTypeSchema } from "./run-type.js";
 import { ResearchAllowanceTypeSchema } from "../research/allowance-type.js";
 /**
@@ -94,6 +95,8 @@ export const HarnessRunSchema = z.object({
     subagentModelRouted: z.boolean().nullish(),
     /** Research presets filed with the run */
     taskPresetKey: z.array(z.string()).nullish(),
+    /** Newest server terminal decision; mutable progress cannot replace it */
+    terminalDecision: HarnessRunTerminalDecisionSchema.nullish(),
     /** Run kind: ENRICHMENT for a research request a caller filed, TASK for a narrower run aVenture scheduled */
     type: HarnessRunTypeSchema,
     /** Last update timestamp */

package/dist/http/problem-detail.d.ts

@@ -68,6 +68,7 @@ export declare const ProblemDetailSchema: z.ZodObject<{
         fundraise_evidence_unsupported: "fundraise_evidence_unsupported";
         geocode_provider_error: "geocode_provider_error";
         github_fetch_failed: "github_fetch_failed";
+        harness_suppression_unverified: "harness_suppression_unverified";
         image_blocklist_match: "image_blocklist_match";
         image_brand_mismatch: "image_brand_mismatch";
         image_monochrome: "image_monochrome";

package/dist/http/problem-detail.js

@@ -26,6 +26,8 @@ export const ProblemDetailSchema = z.object({
     code: z
         .union([
         z.enum([
+            /** The run's suppression of its accepted full-run entity is unverified. Retain the original failure outcome and terminal evidence. */
+            "harness_suppression_unverified",
             /** An anonymous caller cannot own a lookup job. Sign in to request async. */
             "async_lookup_sign_in_required",
             /** Caller is authenticated but lacks the required role for this operation. Agent action: surface the requiredRole field on the ProblemDetail and stop; do not retry without role escalation. */

package/dist/openapi-component-manifest.js

@@ -746,6 +746,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "HarnessRunRequestOutcomeStatusSchema",
     },
     HarnessRunStatus: { modulePath: "harness/run-status", schemaName: "HarnessRunStatusSchema" },
+    HarnessRunTerminalDecision: {
+        modulePath: "harness/run-terminal-decision",
+        schemaName: "HarnessRunTerminalDecisionSchema",
+    },
     HarnessRunTurn: { modulePath: "harness/run-turn", schemaName: "HarnessRunTurnSchema" },
     HarnessRunType: { modulePath: "harness/run-type", schemaName: "HarnessRunTypeSchema" },
     HarnessTaskFact: { modulePath: "harness/task-fact", schemaName: "HarnessTaskFactSchema" },

package/dist/pagination/schemas.d.ts

@@ -14656,6 +14656,22 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
         subagentModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        terminalDecision: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            engineId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            iteration: z.ZodInt;
+            lockedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            sequence: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                queued: "queued";
+                running: "running";
+                stopped: "stopped";
+            }>;
+            suppressionEntityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            suppressionProvenanceEventId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
         type: z.ZodEnum<{
             ENRICHMENT: "ENRICHMENT";
             TASK: "TASK";

package/package.json

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