@aventurevc/api-schemas 0.8.358 → 0.8.360

package/dist/enrichment/batch.d.ts

@@ -14,6 +14,19 @@ declare const EnrichmentBatchSchemaDefinition: z.ZodObject<{
         };
         userPrompt?: string | null | undefined;
     }, import("./instruction.ts").EnrichmentInstructionSchemaInput>>>>;
+    lane: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        background: "background";
+        bulk: "bulk";
+        interactive: "interactive";
+        live: "live";
+    }>, z.ZodString]> & {
+        enum: {
+            background: "background";
+            bulk: "bulk";
+            interactive: "interactive";
+            live: "live";
+        };
+    }>>;
     mode: z.ZodOptional<z.ZodEnum<{
         COMPREHENSIVE: "COMPREHENSIVE";
         INDIVIDUAL: "INDIVIDUAL";

package/dist/enrichment/batch.js

@@ -2,11 +2,14 @@
 import { z } from "zod/v4";
 import { EnrichmentInstructionSchema } from "./instruction.js";
 import { EnrichmentModeSchema } from "./mode.js";
+import { HarnessRunLaneSchema } from "../harness/run-lane.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(),
+    /** Origin priority: live for lookup, interactive for an individual request, or bulk for a client batch (the default when omitted). Background is reserved for system backlog */
+    lane: HarnessRunLaneSchema.nullish(),
     /** 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 */

package/dist/enrichment/enrichment.d.ts

@@ -33,6 +33,15 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
             unassigned: "unassigned";
         }>;
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            DIRECT: "DIRECT";
+            ENGINE: "ENGINE";
+        }>, z.ZodString]> & {
+            enum: {
+                DIRECT: "DIRECT";
+                ENGINE: "ENGINE";
+            };
+        }>>;
         failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         firstStart: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -90,6 +99,15 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
                 WEB_SEARCH: "WEB_SEARCH";
             };
         }>>;
+        researchOutcome: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            BLOCKED: "BLOCKED";
+            PARTIAL: "PARTIAL";
+        }>, z.ZodString]> & {
+            enum: {
+                BLOCKED: "BLOCKED";
+                PARTIAL: "PARTIAL";
+            };
+        }>>;
         resumeSafeUntil: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         startedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         status: z.ZodEnum<{

package/dist/harness/research-outcome.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+/**
+ * Unsuccessful direct-session research disposition
+ *
+ * @openapiSchema HarnessResearchOutcome
+ * @endpoint GET /v1/research-runs
+ * @endpoint GET /v1/research/runs
+ * @endpoint GET /v1/research-runs/{runId}
+ * @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
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.research-outcome
+ * @contractRole canonical
+ */
+export declare const HarnessResearchOutcomeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    BLOCKED: "BLOCKED";
+    PARTIAL: "PARTIAL";
+}>, z.ZodString]> & {
+    enum: {
+        BLOCKED: "BLOCKED";
+        PARTIAL: "PARTIAL";
+    };
+};
+export type HarnessResearchOutcome = z.infer<typeof HarnessResearchOutcomeSchema>;
+//# sourceMappingURL=research-outcome.d.ts.map

package/dist/harness/research-outcome.js

@@ -0,0 +1,22 @@
+// 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 HarnessResearchOutcomeSchemaKnownMembers = z.enum(["PARTIAL", "BLOCKED"]);
+/**
+ * Unsuccessful direct-session research disposition
+ *
+ * @openapiSchema HarnessResearchOutcome
+ * @endpoint GET /v1/research-runs
+ * @endpoint GET /v1/research/runs
+ * @endpoint GET /v1/research-runs/{runId}
+ * @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
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.research-outcome
+ * @contractRole canonical
+ */
+export const HarnessResearchOutcomeSchema = Object.assign(z.union([HarnessResearchOutcomeSchemaKnownMembers, z.string()]), { enum: HarnessResearchOutcomeSchemaKnownMembers.enum });
+//# sourceMappingURL=research-outcome.js.map

package/dist/harness/run-create.js

@@ -12,7 +12,7 @@ const HarnessRunCreateSchemaDefinition = z.object({
     model: z.string().nullish(),
     /** Name of the subject at url, such as Clarity Health; the run verifies it and uses it to pick the right subject when the site names several */
     name: z.string().max(200).nullish(),
-    /** Requester values keyed by the selected task's input definitions. ENTITY binds from url and a supplied entityId must match it. TEXT requires explicit text; a missing required or ambiguous supplied value is rejected before enqueue; omitted optional inputs stay unbound. Never infer values from userPrompt. */
+    /** Requester values keyed by the selected task's input definitions. ENTITY binds from url and a supplied entityId must match it; a task declaring several ENTITY inputs binds one from url and takes each other as the keyed entityId of an existing record (404 when none exists). TEXT requires explicit text; a missing required or ambiguous supplied value is rejected before enqueue; omitted optional inputs stay unbound. Never infer values from userPrompt. */
     taskInput: z.array(HarnessTaskInputBindingSchema).optional(),
     /** Research presets that focus the run, listed by GET /v1/research/runs/presets; omit them for a full run */
     taskPresetKey: z.array(z.string()).nullish(),

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

@@ -182,6 +182,15 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
             unassigned: "unassigned";
         }>;
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            DIRECT: "DIRECT";
+            ENGINE: "ENGINE";
+        }>, z.ZodString]> & {
+            enum: {
+                DIRECT: "DIRECT";
+                ENGINE: "ENGINE";
+            };
+        }>>;
         failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         firstStart: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -239,6 +248,15 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
                 WEB_SEARCH: "WEB_SEARCH";
             };
         }>>;
+        researchOutcome: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            BLOCKED: "BLOCKED";
+            PARTIAL: "PARTIAL";
+        }>, z.ZodString]> & {
+            enum: {
+                BLOCKED: "BLOCKED";
+                PARTIAL: "PARTIAL";
+            };
+        }>>;
         resumeSafeUntil: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         startedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         status: z.ZodEnum<{

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

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+/**
+ * Executor of the accepted research work; independent of its requested scope
+ *
+ * @openapiSchema HarnessRunExecution
+ * @endpoint GET /v1/research-runs
+ * @endpoint GET /v1/research/runs
+ * @endpoint GET /v1/research-runs/{runId}
+ * @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
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-execution
+ * @contractRole canonical
+ */
+export declare const HarnessRunExecutionSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    DIRECT: "DIRECT";
+    ENGINE: "ENGINE";
+}>, z.ZodString]> & {
+    enum: {
+        DIRECT: "DIRECT";
+        ENGINE: "ENGINE";
+    };
+};
+export type HarnessRunExecution = z.infer<typeof HarnessRunExecutionSchema>;
+//# sourceMappingURL=run-execution.d.ts.map

package/dist/harness/run-execution.js

@@ -0,0 +1,22 @@
+// 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 HarnessRunExecutionSchemaKnownMembers = z.enum(["ENGINE", "DIRECT"]);
+/**
+ * Executor of the accepted research work; independent of its requested scope
+ *
+ * @openapiSchema HarnessRunExecution
+ * @endpoint GET /v1/research-runs
+ * @endpoint GET /v1/research/runs
+ * @endpoint GET /v1/research-runs/{runId}
+ * @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
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessRunSchema
+ * @contractShape harness.run-execution
+ * @contractRole canonical
+ */
+export const HarnessRunExecutionSchema = Object.assign(z.union([HarnessRunExecutionSchemaKnownMembers, z.string()]), { enum: HarnessRunExecutionSchemaKnownMembers.enum });
+//# sourceMappingURL=run-execution.js.map

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

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

package/dist/harness/run-lane.js

@@ -14,6 +14,7 @@ const HarnessRunLaneSchemaKnownMembers = z.enum(["live", "interactive", "bulk",
  * @endpoint POST /v1/people/{personId}/enrichments
  * @endpoint POST /v1/research-runs
  * @endpoint POST /v1/research/runs
+ * @usedBySchema EnrichmentBatchSchema
  * @usedBySchema HarnessRunSchema
  * @contractShape harness.run-lane
  * @contractRole canonical

package/dist/harness/run.d.ts

@@ -34,6 +34,15 @@ export declare const HarnessRunSchema: z.ZodObject<{
         unassigned: "unassigned";
     }>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        DIRECT: "DIRECT";
+        ENGINE: "ENGINE";
+    }>, z.ZodString]> & {
+        enum: {
+            DIRECT: "DIRECT";
+            ENGINE: "ENGINE";
+        };
+    }>>;
     failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     firstStart: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -91,6 +100,15 @@ export declare const HarnessRunSchema: z.ZodObject<{
             WEB_SEARCH: "WEB_SEARCH";
         };
     }>>;
+    researchOutcome: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        BLOCKED: "BLOCKED";
+        PARTIAL: "PARTIAL";
+    }>, z.ZodString]> & {
+        enum: {
+            BLOCKED: "BLOCKED";
+            PARTIAL: "PARTIAL";
+        };
+    }>>;
     resumeSafeUntil: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     startedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     status: z.ZodEnum<{

package/dist/harness/run.js

@@ -3,7 +3,9 @@ import { z } from "zod/v4";
 import { EnrichmentModeSchema } from "../enrichment/mode.js";
 import { HarnessChassisSchema } from "./chassis.js";
 import { HarnessLlmApiSchema } from "./llm-api.js";
+import { HarnessResearchOutcomeSchema } from "./research-outcome.js";
 import { HarnessRunEnvironmentSchema } from "./run-environment.js";
+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";
@@ -43,6 +45,8 @@ export const HarnessRunSchema = z.object({
     environment: HarnessRunEnvironmentSchema,
     /** Why the run failed; null unless failed */
     error: z.string().nullish(),
+    /** Executor of this research attempt; absent on older APIs */
+    execution: HarnessRunExecutionSchema.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 */
@@ -69,7 +73,7 @@ export const HarnessRunSchema = z.object({
     maxScoutConcurrent: z.int(),
     /** Enrichment breadth selected for this run */
     mode: EnrichmentModeSchema,
-    /** Model the run uses */
+    /** Engine model */
     model: z.string(),
     /** True when the requester left `model` to the auto router, which picks it again each time the run leaves the queue; null on engine lease responses */
     modelRouted: z.boolean().nullish(),
@@ -77,6 +81,8 @@ export const HarnessRunSchema = z.object({
     nextAttemptAt: z.iso.datetime({ offset: true }).nullish(),
     /** Research allowance this run reserved when it was filed: COMPANY or PERSON; null for a run filed without one */
     researchAllowanceType: ResearchAllowanceTypeSchema.nullish(),
+    /** Partial or blocked direct research, derived from its recorded failure class; null for other outcomes */
+    researchOutcome: HarnessResearchOutcomeSchema.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 */

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

@@ -127,6 +127,7 @@ export declare const ProblemDetailSchema: z.ZodObject<{
         showOnSitemap: z.ZodBoolean;
         slug: z.ZodString;
     }, z.core.$strip>>>;
+    coveringRunId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     detail: z.ZodOptional<z.ZodString>;
     details: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodType<{
         conflictType: string;

package/dist/http/problem-detail.js

@@ -196,6 +196,8 @@ export const ProblemDetailSchema = z.object({
     ])
         .nullish(),
     conflictingRecord: CurrentSlugOwnerSchema.nullish(),
+    /** The caller's own queued or running research request that already covers the record on a harness-run-already-requested problem; absent when another requester or aVenture filed it, and for every other problem. */
+    coveringRunId: z.uuid().nullish(),
     detail: z.string().optional(),
     /** Structured conflict details. A possible duplicate or an ambiguous lookup returns its candidate records; score and threshold rank the candidates and do not prove that the requested record is absent. */
     details: DomainConflictDetailsSchema.nullish(),

package/dist/identification/subject.d.ts

@@ -72,6 +72,9 @@ export declare const IdentificationSubjectSchema: z.ZodObject<{
     location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        INVESTOR: "INVESTOR";
+    }>>>;
     sourceDocumentId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     sourceIdentifier: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         effectiveFrom: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/identification/subject.js

@@ -35,6 +35,8 @@ export const IdentificationSubjectSchema = z.object({
     name: z.string().max(200).nullish(),
     /** Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup. */
     providerId: z.uuid().nullish(),
+    /** Part the subject plays in the source: INVESTOR when the source lists it as an investor. Unlike typeRecord it keeps every record type a candidate, so a Company or Nonprofit that invests can still match. With it, a lookup with no url, filing, sourceIdentifier, or sourceNewsId binds a same-named Investment Firm or Fund over a record that does not invest, and answers NEEDS_REVIEW when the bound record shares its name with another live firm or record of its type family, unless the location matches only the bound record's address. Without it, an Investment Firm or Fund typeRecord applies the firm preference alone. Omit it otherwise. */
+    role: z.enum(["INVESTOR"]).nullish(),
     /** Exact stored capture of sourceUrl, never an owned website. Requires capture-read authority and a matching successful evidence body; cannot accompany sourceNewsId. */
     sourceDocumentId: z.uuid().nullish(),
     /** Permanent source identity with idType and identifier for a catalog source-binding type. Legacy source may be omitted or null; non-null labels are rejected. Requires private visibility and resolves before names or URLs. */

package/dist/lookup/job-mutation.d.ts

@@ -73,6 +73,9 @@ declare const LookupJobMutationSchemaDefinition: z.ZodObject<{
         location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            INVESTOR: "INVESTOR";
+        }>>>;
         sourceDocumentId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
         sourceIdentifier: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             effectiveFrom: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/lookup/job.d.ts

@@ -2218,6 +2218,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             location?: string | null | undefined;
             name?: string | null | undefined;
             providerId?: string | null | undefined;
+            role?: "INVESTOR" | null | undefined;
             sourceDocumentId?: string | null | undefined;
             sourceIdentifier?: {
                 effectiveFrom?: string | null | undefined;
@@ -2282,6 +2283,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             location?: string | null | undefined;
             name?: string | null | undefined;
             providerId?: string | null | undefined;
+            role?: "INVESTOR" | null | undefined;
             sourceDocumentId?: string | null | undefined;
             sourceIdentifier?: {
                 effectiveFrom?: string | null | undefined;
@@ -2308,6 +2310,17 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             statusUrl: z.ZodString;
         }, z.core.$strip>>>;
         faviconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            ARTICLE: "ARTICLE";
+            POST: "POST";
+            PROFILE: "PROFILE";
+        }>, z.ZodString]> & {
+            enum: {
+                ARTICLE: "ARTICLE";
+                POST: "POST";
+                PROFILE: "PROFILE";
+            };
+        }>>;
         logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         message: z.ZodArray<z.ZodString>;
         p95Ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;

package/dist/lookup/job.js

@@ -31,7 +31,7 @@ const LookupJobSchemaDefinition = z.object({
     news: NewsSchema.nullish(),
     /** The article the job reads or names supplied for a bulk lookup. */
     source: LookupJobMutationSchema,
-    /** Publisher-reading activity for a durably accepted shared-article lookup. */
+    /** Source-reading activity for a durably accepted shared article, post, or profile lookup. */
     sourceRead: LookupSourceReadSchema.nullish(),
     /** Current job state. */
     state: JobStateSchema,

package/dist/lookup/source-kind.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+/**
+ * What a lookup's source is, so a client names it while it loads: a news article, a LinkedIn or X post, or a supplied profile. An unknown future kind reads as a generic source.
+ *
+ * @openapiSchema LookupSourceKind
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/lookup/mentions
+ * @usedBySchema LookupSourceReadSchema
+ * @contractShape lookup.source-kind
+ * @contractRole canonical
+ */
+export declare const LookupSourceKindSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    ARTICLE: "ARTICLE";
+    POST: "POST";
+    PROFILE: "PROFILE";
+}>, z.ZodString]> & {
+    enum: {
+        ARTICLE: "ARTICLE";
+        POST: "POST";
+        PROFILE: "PROFILE";
+    };
+};
+export type LookupSourceKind = z.infer<typeof LookupSourceKindSchema>;
+//# sourceMappingURL=source-kind.d.ts.map

package/dist/lookup/source-kind.js

@@ -0,0 +1,17 @@
+// 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 LookupSourceKindSchemaKnownMembers = z.enum(["ARTICLE", "POST", "PROFILE"]);
+/**
+ * What a lookup's source is, so a client names it while it loads: a news article, a LinkedIn or X post, or a supplied profile. An unknown future kind reads as a generic source.
+ *
+ * @openapiSchema LookupSourceKind
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/lookup/mentions
+ * @usedBySchema LookupSourceReadSchema
+ * @contractShape lookup.source-kind
+ * @contractRole canonical
+ */
+export const LookupSourceKindSchema = Object.assign(z.union([LookupSourceKindSchemaKnownMembers, z.string()]), { enum: LookupSourceKindSchemaKnownMembers.enum });
+//# sourceMappingURL=source-kind.js.map

package/dist/lookup/source-read.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Source context and honest reading activity for a shared article or profile.
+ * Source context and honest reading activity for a shared article, post, or profile.
  *
  * @openapiSchema LookupSourceRead
  * @endpoint GET /v1/lookup-jobs/{jobId}
@@ -20,6 +20,17 @@ export declare const LookupSourceReadSchema: z.ZodObject<{
         statusUrl: z.ZodString;
     }, z.core.$strip>>>;
     faviconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        ARTICLE: "ARTICLE";
+        POST: "POST";
+        PROFILE: "PROFILE";
+    }>, z.ZodString]> & {
+        enum: {
+            ARTICLE: "ARTICLE";
+            POST: "POST";
+            PROFILE: "PROFILE";
+        };
+    }>>;
     logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     message: z.ZodArray<z.ZodString>;
     p95Ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;

package/dist/lookup/source-read.js

@@ -1,9 +1,10 @@
 // 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 { JobEnqueueSchema } from "../job/enqueue.js";
+import { LookupSourceKindSchema } from "./source-kind.js";
 import { LookupSourceReadPhaseSchema } from "./source-read-phase.js";
 /**
- * Source context and honest reading activity for a shared article or profile.
+ * Source context and honest reading activity for a shared article, post, or profile.
  *
  * @openapiSchema LookupSourceRead
  * @endpoint GET /v1/lookup-jobs/{jobId}
@@ -19,6 +20,8 @@ export const LookupSourceReadSchema = z.object({
     /** A committed durable lookup to follow; only its presence permits a promise to leave and return. Follow its status URL with the same caller's bearer, honoring Retry-After. */
     continuation: JobEnqueueSchema.nullish(),
     faviconUrl: z.string().nullish(),
+    /** What the source is, so a client names it while it loads; absent only on a lookup an earlier revision accepted. */
+    kind: LookupSourceKindSchema.nullish(),
     logoUrl: z.string().nullish(),
     /** Informational messages to cycle within this stage, never evidence of completed work. */
     message: z.array(z.string()),

package/dist/mention/lookup.d.ts

@@ -1938,6 +1938,17 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
             statusUrl: z.ZodString;
         }, z.core.$strip>>>;
         faviconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            ARTICLE: "ARTICLE";
+            POST: "POST";
+            PROFILE: "PROFILE";
+        }>, z.ZodString]> & {
+            enum: {
+                ARTICLE: "ARTICLE";
+                POST: "POST";
+                PROFILE: "PROFILE";
+            };
+        }>>;
         logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         message: z.ZodArray<z.ZodString>;
         p95Ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;

package/dist/openapi-component-manifest.js

@@ -700,6 +700,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     GithubRepo: { modulePath: "github/repo", schemaName: "GithubRepoSchema" },
     HarnessChassis: { modulePath: "harness/chassis", schemaName: "HarnessChassisSchema" },
     HarnessLlmApi: { modulePath: "harness/llm-api", schemaName: "HarnessLlmApiSchema" },
+    HarnessResearchOutcome: {
+        modulePath: "harness/research-outcome",
+        schemaName: "HarnessResearchOutcomeSchema",
+    },
     HarnessRun: { modulePath: "harness/run", schemaName: "HarnessRunSchema" },
     HarnessRunActivity: {
         modulePath: "harness/run-activity",
@@ -716,6 +720,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "HarnessRunEnvironmentSchema",
     },
     HarnessRunEvent: { modulePath: "harness/run-event", schemaName: "HarnessRunEventSchema" },
+    HarnessRunExecution: {
+        modulePath: "harness/run-execution",
+        schemaName: "HarnessRunExecutionSchema",
+    },
     HarnessRunFollowUp: {
         modulePath: "harness/run-follow-up",
         schemaName: "HarnessRunFollowUpSchema",
@@ -812,6 +820,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     LookupJobMention: { modulePath: "lookup/job-mention", schemaName: "LookupJobMentionSchema" },
     LookupJobMutation: { modulePath: "lookup/job-mutation", schemaName: "LookupJobMutationSchema" },
     LookupMention: { modulePath: "lookup/mention", schemaName: "LookupMentionSchema" },
+    LookupSourceKind: { modulePath: "lookup/source-kind", schemaName: "LookupSourceKindSchema" },
     LookupSourceRead: { modulePath: "lookup/source-read", schemaName: "LookupSourceReadSchema" },
     LookupSourceReadPhase: {
         modulePath: "lookup/source-read-phase",

package/dist/pagination/schemas.d.ts

@@ -13989,6 +13989,15 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
             unassigned: "unassigned";
         }>;
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            DIRECT: "DIRECT";
+            ENGINE: "ENGINE";
+        }>, z.ZodString]> & {
+            enum: {
+                DIRECT: "DIRECT";
+                ENGINE: "ENGINE";
+            };
+        }>>;
         failureClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         finishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         firstStart: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -14046,6 +14055,15 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
                 WEB_SEARCH: "WEB_SEARCH";
             };
         }>>;
+        researchOutcome: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            BLOCKED: "BLOCKED";
+            PARTIAL: "PARTIAL";
+        }>, z.ZodString]> & {
+            enum: {
+                BLOCKED: "BLOCKED";
+                PARTIAL: "PARTIAL";
+            };
+        }>>;
         resumeSafeUntil: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         startedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         status: z.ZodEnum<{

package/dist/person/person.js

@@ -22,6 +22,7 @@ const PersonSchemaDefinition = z.object({
     nameFirst: z.string().nullish(),
     nameFull: z.string(),
     nameLast: z.string().nullish(),
+    /** Middle name as stored after name normalization */
     nameMiddle: z.string().nullish(),
     nickname: z.string().nullish(),
     /** Stable, immutable public handle (e.g. `pV1StGXR8Z5ab`). Never changes once assigned, unlike the slug. Null on projections that do not select it and on rows still awaiting handle backfill. */

package/dist/problem/type.d.ts

@@ -40,6 +40,7 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     readonly ENDPOINT_NOT_FOUND: "https://api.aventure.vc/errors/endpoint-not-found";
     readonly GONE: "https://api.aventure.vc/errors/gone";
     readonly RATE_LIMITED: "https://api.aventure.vc/errors/rate-limited";
+    readonly HARNESS_RUN_ALREADY_REQUESTED: "https://api.aventure.vc/errors/harness-run-already-requested";
     readonly PRECONDITION_FAILED: "https://api.aventure.vc/errors/precondition-failed";
     readonly PRECONDITION_REQUIRED: "https://api.aventure.vc/errors/precondition-required";
     readonly BILLING_ALLOWANCE_EXHAUSTED: "https://api.aventure.vc/errors/billing-allowance-exhausted";
@@ -103,6 +104,7 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         readonly ENDPOINT_NOT_FOUND: "https://api.aventure.vc/errors/endpoint-not-found";
         readonly GONE: "https://api.aventure.vc/errors/gone";
         readonly RATE_LIMITED: "https://api.aventure.vc/errors/rate-limited";
+        readonly HARNESS_RUN_ALREADY_REQUESTED: "https://api.aventure.vc/errors/harness-run-already-requested";
         readonly PRECONDITION_FAILED: "https://api.aventure.vc/errors/precondition-failed";
         readonly PRECONDITION_REQUIRED: "https://api.aventure.vc/errors/precondition-required";
         readonly BILLING_ALLOWANCE_EXHAUSTED: "https://api.aventure.vc/errors/billing-allowance-exhausted";

package/dist/problem/type.js

@@ -32,6 +32,7 @@ const ProblemTypeSchemaKnownMembers = z.enum({
     ENDPOINT_NOT_FOUND: "https://api.aventure.vc/errors/endpoint-not-found",
     GONE: "https://api.aventure.vc/errors/gone",
     RATE_LIMITED: "https://api.aventure.vc/errors/rate-limited",
+    HARNESS_RUN_ALREADY_REQUESTED: "https://api.aventure.vc/errors/harness-run-already-requested",
     PRECONDITION_FAILED: "https://api.aventure.vc/errors/precondition-failed",
     PRECONDITION_REQUIRED: "https://api.aventure.vc/errors/precondition-required",
     BILLING_ALLOWANCE_EXHAUSTED: "https://api.aventure.vc/errors/billing-allowance-exhausted",

package/package.json

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