@aventurevc/api-schemas 0.8.427 → 0.8.429

package/dist/blog/post.js

@@ -20,7 +20,7 @@ const BlogPostSchemaDefinition = z.object({
     /** Owning record, nested ids only: owner.entityId or owner.personId — exactly one is set. */
     owner: EntityPersonOwnerSchema,
     publishedAt: z.iso.datetime({ offset: true }).nullish(),
-    /** LLM-generated blog-post summary from blog-post-ingest */
+    /** Short generated summary of the post */
     summary: z.string().nullish(),
     /** Timestamp when summary was last generated */
     summaryGeneratedAt: z.iso.datetime({ offset: true }).nullish(),

package/dist/enrichment/batch.js

@@ -8,7 +8,7 @@ const EnrichmentBatchSchemaDefinition = z.object({
     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 */
+    /** Origin priority: live for lookup, interactive for an individual request, or bulk for a client batch (the default when omitted) */
     lane: HarnessRunLaneSchema.nullish(),
     /** COMPREHENSIVE (the default) researches each whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey */
     mode: EnrichmentModeSchema.optional(),

package/dist/enrichment/enrichment.d.ts

@@ -24,15 +24,15 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
             "claude-agent-sdk": "claude-agent-sdk";
             "pi-agent-sdk": "pi-agent-sdk";
         }>>>;
-        chassisRouted: z.ZodBoolean;
+        chassisRouted: z.ZodOptional<z.ZodBoolean>;
         createdAt: z.ZodISODateTime;
         entitySlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        environment: z.ZodEnum<{
+        environment: z.ZodOptional<z.ZodEnum<{
             development: "development";
             production: "production";
             staging: "staging";
             unassigned: "unassigned";
-        }>;
+        }>>;
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
             DIRECT: "DIRECT";
@@ -74,8 +74,8 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
             "openai-chat": "openai-chat";
             "openai-responses": "openai-responses";
         }>>>;
-        maxIteration: z.ZodInt;
-        maxScoutConcurrent: z.ZodInt;
+        maxIteration: z.ZodOptional<z.ZodInt>;
+        maxScoutConcurrent: z.ZodOptional<z.ZodInt>;
         mode: z.ZodEnum<{
             COMPREHENSIVE: "COMPREHENSIVE";
             INDIVIDUAL: "INDIVIDUAL";

package/dist/enrichment/prompt.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 declare const EnrichmentPromptSchemaDefinition: z.ZodObject<{
     finding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;
@@ -11,6 +12,7 @@ declare const EnrichmentPromptSchemaDefinition: z.ZodObject<{
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;

package/dist/entity/analysis-citation.d.ts

@@ -1,5 +1,14 @@
 import { z } from "zod/v4";
 declare const EntityAnalysisCitationSchemaDefinition: z.ZodObject<{
+    evidenceView: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        ARTICLE_V1: "ARTICLE_V1";
+        LEGACY: "LEGACY";
+    }>, z.ZodString]> & {
+        enum: {
+            ARTICLE_V1: "ARTICLE_V1";
+            LEGACY: "LEGACY";
+        };
+    }>>;
     quote: z.ZodString;
     sourceDocumentId: z.ZodUUID;
 }, z.core.$strip>;

package/dist/entity/analysis-citation.js

@@ -1,6 +1,9 @@
 // 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 { SourceDocumentEvidenceViewSchema } from "../source/document-evidence-view.js";
 const EntityAnalysisCitationSchemaDefinition = z.object({
+    /** Captured-text view of this quote; omitted values retain LEGACY. */
+    evidenceView: SourceDocumentEvidenceViewSchema.nullish(),
     /** Nonempty verbatim quote to verify against the archived document. */
     quote: z.string(),
     /** Canonical archived source document UUID. */

package/dist/entity/analysis-draft.d.ts

@@ -4,6 +4,7 @@ declare const EntityAnalysisDraftSchemaDefinition: z.ZodObject<{
     runId: z.ZodUUID;
     section: z.ZodArray<z.ZodType<{
         citation: {
+            evidenceView?: string | null | undefined;
             quote: string;
             sourceDocumentId: string;
         }[];
@@ -28,6 +29,7 @@ declare const EntityAnalysisDraftSchemaDefinition: z.ZodObject<{
         title: string;
     }, import("./analysis-section.ts").EntityAnalysisSectionSchemaInput, z.core.$ZodTypeInternals<{
         citation: {
+            evidenceView?: string | null | undefined;
             quote: string;
             sourceDocumentId: string;
         }[];

package/dist/entity/analysis-section-mutation.d.ts

@@ -1,9 +1,11 @@
 import { z } from "zod/v4";
 declare const EntityAnalysisSectionMutationSchemaDefinition: z.ZodObject<{
     citation: z.ZodArray<z.ZodType<{
+        evidenceView?: string | null | undefined;
         quote: string;
         sourceDocumentId: string;
     }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput, z.core.$ZodTypeInternals<{
+        evidenceView?: string | null | undefined;
         quote: string;
         sourceDocumentId: string;
     }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput>>>;
@@ -51,6 +53,7 @@ declare const EntityAnalysisSectionMutationSchemaDefinition: z.ZodObject<{
     writerBrief: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         claim: z.ZodArray<z.ZodType<{
             end?: number | null | undefined;
+            evidenceView?: string | null | undefined;
             gateId?: string | null | undefined;
             quote?: string | undefined;
             sourceDocumentId?: string | null | undefined;
@@ -60,6 +63,7 @@ declare const EntityAnalysisSectionMutationSchemaDefinition: z.ZodObject<{
             writerSurface?: string | null | undefined;
         }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
             end?: number | null | undefined;
+            evidenceView?: string | null | undefined;
             gateId?: string | null | undefined;
             quote?: string | undefined;
             sourceDocumentId?: string | null | undefined;

package/dist/entity/analysis-section.d.ts

@@ -1,9 +1,11 @@
 import { z } from "zod/v4";
 declare const EntityAnalysisSectionSchemaDefinition: z.ZodObject<{
     citation: z.ZodArray<z.ZodType<{
+        evidenceView?: string | null | undefined;
         quote: string;
         sourceDocumentId: string;
     }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput, z.core.$ZodTypeInternals<{
+        evidenceView?: string | null | undefined;
         quote: string;
         sourceDocumentId: string;
     }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput>>>;

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

@@ -219,22 +219,16 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
         freshness?: "auto" | "cached" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;
-        modelCatalogRevision?: number | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
-        searchCatalogRevision?: number | null | undefined;
-        tenantPolicyRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput, z.core.$ZodTypeInternals<{
         answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
         freshness?: "auto" | "cached" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;
-        modelCatalogRevision?: number | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
-        searchCatalogRevision?: number | null | undefined;
-        tenantPolicyRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput>>;
     sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;

package/dist/entity/writer-brief.d.ts

@@ -11,6 +11,7 @@ import { z } from "zod/v4";
 export declare const EntityWriterBriefSchema: z.ZodObject<{
     claim: z.ZodArray<z.ZodType<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;
@@ -20,6 +21,7 @@ export declare const EntityWriterBriefSchema: z.ZodObject<{
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;

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

@@ -241,7 +241,6 @@ declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
         };
     }>>;
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    modelCatalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     newsSize: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     personSize: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     query: z.ZodString;
@@ -262,9 +261,7 @@ declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
             xhigh: "xhigh";
         };
     }>>;
-    searchCatalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
-    tenantPolicyRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;
 type FederatedNaturalSearchDefinition = z.infer<typeof FederatedNaturalSearchSchemaDefinition>;
 export interface FederatedNaturalSearchSchemaInput extends z.input<typeof FederatedNaturalSearchSchemaDefinition> {

package/dist/federated/natural-search.js

@@ -18,8 +18,6 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     mode: SearchModeSchema.default("auto").optional(),
     /** Optional supported model id for planning the search. Leave the field out for the server's model; a value that is not a supported model id answers 422. */
     model: z.string().nullish(),
-    /** Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
-    modelCatalogRevision: z.int().nullish(),
     /** News scope page size; defaults to 4, matching the aventure.vc search page, under the same page-size cap. Explicit null uses the size query parameter. */
     newsSize: z.int().nullish(),
     /** Person scope page size; defaults to 10, matching the aventure.vc search page, under the same page-size cap. Explicit null uses the size query parameter. */
@@ -28,12 +26,8 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     query: z.string().min(1),
     /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. */
     reasoningEffort: ReasoningEffortSchema.nullish(),
-    /** Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
-    searchCatalogRevision: z.int().nullish(),
     /** The stored aVenture news article this search started from. Its approved public Company and Business Line mentions lead the entity scope as subjects in mention order. An unknown or non-public article, or one without such mentions, keeps the ordinary headline search. Other scopes and answer generation are unchanged. */
     sourceNewsId: z.int().min(1).nullish(),
-    /** Runtime policy revision this search uses for the serving deployment's execution budgets; null reads that deployment's current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
-    tenantPolicyRevision: z.int().nullish(),
 });
 /**
  * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.

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

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
     finding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;
@@ -11,6 +12,7 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;
@@ -30,6 +32,7 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         entityWriterBrief?: {
             claim: {
                 end?: number | null | undefined;
+                evidenceView?: string | null | undefined;
                 gateId?: string | null | undefined;
                 quote?: string | undefined;
                 sourceDocumentId?: string | null | undefined;
@@ -85,6 +88,7 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         writerBrief?: {
             claim: {
                 end?: number | null | undefined;
+                evidenceView?: string | null | undefined;
                 gateId?: string | null | undefined;
                 quote?: string | undefined;
                 sourceDocumentId?: string | null | undefined;
@@ -142,6 +146,7 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         entityWriterBrief?: {
             claim: {
                 end?: number | null | undefined;
+                evidenceView?: string | null | undefined;
                 gateId?: string | null | undefined;
                 quote?: string | undefined;
                 sourceDocumentId?: string | null | undefined;
@@ -197,6 +202,7 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         writerBrief?: {
             claim: {
                 end?: number | null | undefined;
+                evidenceView?: string | null | undefined;
                 gateId?: string | null | undefined;
                 quote?: string | undefined;
                 sourceDocumentId?: string | null | undefined;

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

@@ -199,15 +199,15 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
             "claude-agent-sdk": "claude-agent-sdk";
             "pi-agent-sdk": "pi-agent-sdk";
         }>>>;
-        chassisRouted: z.ZodBoolean;
+        chassisRouted: z.ZodOptional<z.ZodBoolean>;
         createdAt: z.ZodISODateTime;
         entitySlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        environment: z.ZodEnum<{
+        environment: z.ZodOptional<z.ZodEnum<{
             development: "development";
             production: "production";
             staging: "staging";
             unassigned: "unassigned";
-        }>;
+        }>>;
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
             DIRECT: "DIRECT";
@@ -249,8 +249,8 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
             "openai-chat": "openai-chat";
             "openai-responses": "openai-responses";
         }>>>;
-        maxIteration: z.ZodInt;
-        maxScoutConcurrent: z.ZodInt;
+        maxIteration: z.ZodOptional<z.ZodInt>;
+        maxScoutConcurrent: z.ZodOptional<z.ZodInt>;
         mode: z.ZodEnum<{
             COMPREHENSIVE: "COMPREHENSIVE";
             INDIVIDUAL: "INDIVIDUAL";

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Queue priority of a run: live (search and lookup) and interactive (one client run) share the interactive queue; bulk (client batch) and background (system backlog) share the background queue
+ * Queue priority of a run: live (search and lookup) and interactive (one client run) share the interactive queue; bulk (client batch) and background (scheduled work) share the background queue
  *
  * @openapiSchema HarnessRunLane
  * @endpoint GET /v1/research/runs

package/dist/harness/run-lane.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 const HarnessRunLaneSchemaKnownMembers = z.enum(["live", "interactive", "bulk", "background"]);
 /**
- * Queue priority of a run: live (search and lookup) and interactive (one client run) share the interactive queue; bulk (client batch) and background (system backlog) share the background queue
+ * Queue priority of a run: live (search and lookup) and interactive (one client run) share the interactive queue; bulk (client batch) and background (scheduled work) share the background queue
  *
  * @openapiSchema HarnessRunLane
  * @endpoint GET /v1/research/runs

package/dist/harness/run.d.ts

@@ -22,15 +22,15 @@ export declare const HarnessRunSchema: z.ZodObject<{
         "claude-agent-sdk": "claude-agent-sdk";
         "pi-agent-sdk": "pi-agent-sdk";
     }>>>;
-    chassisRouted: z.ZodBoolean;
+    chassisRouted: z.ZodOptional<z.ZodBoolean>;
     createdAt: z.ZodISODateTime;
     entitySlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    environment: z.ZodEnum<{
+    environment: z.ZodOptional<z.ZodEnum<{
         development: "development";
         production: "production";
         staging: "staging";
         unassigned: "unassigned";
-    }>;
+    }>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
         DIRECT: "DIRECT";
@@ -72,8 +72,8 @@ export declare const HarnessRunSchema: z.ZodObject<{
         "openai-chat": "openai-chat";
         "openai-responses": "openai-responses";
     }>>>;
-    maxIteration: z.ZodInt;
-    maxScoutConcurrent: z.ZodInt;
+    maxIteration: z.ZodOptional<z.ZodInt>;
+    maxScoutConcurrent: z.ZodOptional<z.ZodInt>;
     mode: z.ZodEnum<{
         COMPREHENSIVE: "COMPREHENSIVE";
         INDIVIDUAL: "INDIVIDUAL";

package/dist/harness/run.js

@@ -35,25 +35,25 @@ export const HarnessRunSchema = z.object({
     callerCanFollowRun: z.boolean().nullish(),
     /** Agent framework this run executes on */
     chassis: HarnessChassisSchema.nullish(),
-    /** True when aVenture, not the caller, chose `chassis` */
-    chassisRouted: z.boolean(),
+    /** True when aVenture chose `chassis` */
+    chassisRouted: z.boolean().optional(),
     /** Creation timestamp */
     createdAt: z.iso.datetime({ offset: true }),
     /** Slug of the profile the run produced */
     entitySlug: z.string().nullish(),
     /** API environment */
-    environment: HarnessRunEnvironmentSchema,
+    environment: HarnessRunEnvironmentSchema.optional(),
     /** 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 */
+    /** Short machine-readable class of the failure, such as runtime_cap; null unless failed */
     failureClass: z.string().nullish(),
     /** Run completion timestamp */
     finishedAt: z.iso.datetime({ offset: true }).nullish(),
     /** Set only in the response that starts the run: true the first time it starts, false when a worker restarts it; null in every other response */
     firstStart: z.boolean().nullish(),
-    /** Whether follow-up runs from this run's latest finish have all been filed; runs finished by older engine versions stay PENDING */
+    /** Whether follow-up runs from this run's latest finish have all been filed; runs finished before this was recorded stay PENDING */
     followUpAdmission: HarnessRunFollowUpAdmissionSchema.optional(),
     /** Whether this run consumes an immutable private source document */
     hasSourceDocument: z.boolean(),
@@ -61,21 +61,21 @@ export const HarnessRunSchema = z.object({
     id: z.uuid(),
     /** Current loop iteration */
     iteration: z.int(),
-    /** Admission class (interactive or background) on client-facing responses; Prefer: run-lane-origin returns the actual queue lane. Engine lifecycle responses always return the actual lane. */
+    /** Admission class, interactive or background; Prefer: run-lane-origin reads the filed lane */
     lane: HarnessRunLaneSchema,
     /** Latest research-loop progress as a free-form JSON string */
     latestStatus: z.string().nullish(),
     /** Language-model API format this run's calls use */
     llmApi: HarnessLlmApiSchema.nullish(),
     /** Loop iteration cap */
-    maxIteration: z.int(),
-    /** How many read-only research helpers the run may use at once */
-    maxScoutConcurrent: z.int(),
+    maxIteration: z.int().optional(),
+    /** Concurrent research helper cap */
+    maxScoutConcurrent: z.int().optional(),
     /** Enrichment breadth selected for this run */
     mode: EnrichmentModeSchema,
-    /** Engine model; absent for direct execution */
+    /** Model id the run uses; absent when none applies */
     model: z.string().nullish(),
-    /** 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 */
+    /** True when the requester left `model` to the auto router, which picks it again each time the run leaves the queue; null when not reported */
     modelRouted: z.boolean().nullish(),
     /** Earliest re-claim time when waiting on retry backoff */
     nextAttemptAt: z.iso.datetime({ offset: true }).nullish(),
@@ -83,7 +83,7 @@ export const HarnessRunSchema = z.object({
     researchAllowanceType: ResearchAllowanceTypeSchema.nullish(),
     /** How unsuccessful research ended: PARTIAL or BLOCKED, 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. */
+    /** Instant past which resuming the run from where it stopped is no longer guaranteed. A failed or stopped run can resume that way while 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(),
@@ -91,7 +91,7 @@ export const HarnessRunSchema = z.object({
     status: HarnessRunStatusSchema,
     /** Model id of the run's read-only research and check helpers */
     subagentModel: z.string().nullish(),
-    /** True when the requester left `subagentModel` to the auto router, which picks it again each time the run leaves the queue; null on engine lease responses */
+    /** True when the requester left `subagentModel` to the auto router, which picks it again each time the run leaves the queue; null when not reported */
     subagentModelRouted: z.boolean().nullish(),
     /** Research presets filed with the run */
     taskPresetKey: z.array(z.string()).nullish(),
@@ -103,7 +103,7 @@ export const HarnessRunSchema = z.object({
     updatedAt: z.iso.datetime({ offset: true }),
     /** URL of the company, Product, Service, or person under research */
     url: z.string(),
-    /** Optional engine instructions. POST /v1/research/runs filing responses acknowledge only the submitted note; subsequent requester list and detail reads omit the combined instructions. Privileged and engine reads retain the full brief. */
+    /** Instructions filed with the run. POST /v1/research/runs filing responses acknowledge only the submitted note; subsequent requester list and detail reads omit the combined instructions. */
     userPrompt: z.string().nullish(),
 });
 //# sourceMappingURL=run.js.map

package/dist/harness/task-input-binding.d.ts

@@ -4,6 +4,7 @@ declare const HarnessTaskInputBindingSchemaDefinition: z.ZodObject<{
     entityWriterBrief: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         claim: z.ZodArray<z.ZodType<{
             end?: number | null | undefined;
+            evidenceView?: string | null | undefined;
             gateId?: string | null | undefined;
             quote?: string | undefined;
             sourceDocumentId?: string | null | undefined;
@@ -13,6 +14,7 @@ declare const HarnessTaskInputBindingSchemaDefinition: z.ZodObject<{
             writerSurface?: string | null | undefined;
         }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
             end?: number | null | undefined;
+            evidenceView?: string | null | undefined;
             gateId?: string | null | undefined;
             quote?: string | undefined;
             sourceDocumentId?: string | null | undefined;
@@ -99,6 +101,7 @@ declare const HarnessTaskInputBindingSchemaDefinition: z.ZodObject<{
     writerBrief: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         claim: z.ZodArray<z.ZodType<{
             end?: number | null | undefined;
+            evidenceView?: string | null | undefined;
             gateId?: string | null | undefined;
             quote?: string | undefined;
             sourceDocumentId?: string | null | undefined;
@@ -108,6 +111,7 @@ declare const HarnessTaskInputBindingSchemaDefinition: z.ZodObject<{
             writerSurface?: string | null | undefined;
         }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
             end?: number | null | undefined;
+            evidenceView?: string | null | undefined;
             gateId?: string | null | undefined;
             quote?: string | undefined;
             sourceDocumentId?: string | null | undefined;

package/dist/harness/task-plan.js

@@ -14,7 +14,7 @@ import { HarnessTaskSchema } from "./task.js";
 export const HarnessTaskPlanSchema = z.object({
     /** Stored catalog revision this plan was read from. */
     catalogRevision: z.int().optional(),
-    /** Ids of the completion checks this task must pass, as listed in the completion check catalog. */
+    /** Ids of the completion checks this task must pass, as listed in the completion check catalog. A run's own plan lists only the checks its accepted target owes; a check that target's entity type or funding stage excludes is omitted. */
     gateId: z.array(z.string()).optional(),
     /** Typed task inputs; required inputs must be bound before it runs. */
     input: z.array(HarnessTaskSchema),

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

@@ -64,7 +64,6 @@ export declare const ProblemDetailSchema: z.ZodObject<{
         clerk_oauth_unavailable: "clerk_oauth_unavailable";
         cvc_inherited_headcount: "cvc_inherited_headcount";
         entity_name_casing_rejected: "entity_name_casing_rejected";
-        frontend_cache_epoch_mode_not_targeted: "frontend_cache_epoch_mode_not_targeted";
         fundraise_evidence_unsupported: "fundraise_evidence_unsupported";
         geocode_provider_error: "geocode_provider_error";
         github_fetch_failed: "github_fetch_failed";
@@ -112,7 +111,6 @@ export declare const ProblemDetailSchema: z.ZodObject<{
         search_provider_not_configured: "search_provider_not_configured";
         search_still_running: "search_still_running";
         sec_edgar_fetch_failed: "sec_edgar_fetch_failed";
-        sentry_api_error: "sentry_api_error";
         source_document_body_unavailable: "source_document_body_unavailable";
         source_document_capture_limit_exceeded: "source_document_capture_limit_exceeded";
         source_document_fetch_busy: "source_document_fetch_busy";
@@ -295,15 +293,10 @@ export declare const ProblemDetailSchema: z.ZodObject<{
         AGENT_HELP: "AGENT_HELP";
         BILLING_ADDITIONAL_USAGE: "BILLING_ADDITIONAL_USAGE";
         BILLING_ALLOWANCE: "BILLING_ALLOWANCE";
-        CLERK_PUBLIC_ADMISSION: "CLERK_PUBLIC_ADMISSION";
-        CLERK_SCRIPT_LOAD: "CLERK_SCRIPT_LOAD";
         FORM: "FORM";
         GLOBAL: "GLOBAL";
-        INFERENCE_PROVIDER: "INFERENCE_PROVIDER";
         IP: "IP";
         NATURAL_SEARCH: "NATURAL_SEARCH";
-        ORIGIN_DETAIL: "ORIGIN_DETAIL";
-        RESILIENCE4J: "RESILIENCE4J";
         SUBNET: "SUBNET";
         UNKNOWN: "UNKNOWN";
         WEB_SEARCH: "WEB_SEARCH";

package/dist/http/problem-detail.js

@@ -54,13 +54,13 @@ export const ProblemDetailSchema = z.object({
             "billing_plan_change_required",
             /** A signed-out purchase named an email that already belongs to an account. Agent action: sign that account in with its email code, then subscribe signed in; never retry the signed-out purchase for that email. */
             "account_exists",
-            /** Detail-origin cold-miss coalescing is saturated. Agent action: treat as backend capacity impairment, back off, and inspect backend pool/bulkhead metrics; this is not a caller throttle. */
+            /** Record-detail reads are at capacity. Agent action: back off and retry later; this is a service capacity condition, not a caller throttle. */
             "origin_detail_capacity",
-            /** Detail-origin cold-miss scheduler rejected work because this instance is shutting down for a redeploy. Agent action: retry shortly; the platform routes the retry to a healthy instance. This is deploy-window noise, not backend saturation. */
+            /** A record-detail read was refused because the serving instance is restarting. Agent action: retry shortly; the retry reaches a healthy instance. */
             "origin_detail_shutdown",
-            /** A read overran its database query budget and was shed before answering, so the identical request can be replayed. Agent action: retry after a short backoff; the shed is expected and files no incident. */
+            /** A read overran its time budget and was shed before answering, so the identical request can be replayed. Agent action: retry after a short backoff; the shed is expected and files no incident. */
             "query_deadline_shed",
-            /** Primary read capacity was saturated; retry after retryAfterSeconds. */
+            /** Read capacity was saturated; retry after retryAfterSeconds. */
             "primary_read_saturated",
             /** Request prose looks shell-mangled around a money phrase: either shell expansion stripped a leading dollar sign ('50 million' where '$50 million' was meant) or an escape character survived into the text ('\$50 million', standalone '/$50 million'). Agent action: write '$' literally and re-send the JSON body from a file or stdin, or quote it so the shell does not expand '$'; use allowSuspectedShellStrip only when the value is intentional. */
             "suspectedShellStrip",
@@ -84,26 +84,22 @@ export const ProblemDetailSchema = z.object({
             "source_grounding_at_capacity",
             /** A URL was submitted to the wrong write surface. Agent action: move the URL to the specific surface named by ProblemDetail.hint/resolution, for example EntityUrl.urlType=ycombinator via entities urls create instead of News.newsUrlOriginal. */
             "url_surface_misclassification",
-            /** JobRunr background worker is disabled in this environment. Agent action: stop (this is an admin/ops configuration condition, not a retriable user error). */
+            /** Background job processing is disabled on this API. Agent action: stop; this is a service configuration condition, not a retriable caller error. */
             "JOBRUNR_DISABLED",
-            /** JobRunr background worker is disabled in this environment. Agent action: stop (this is an admin/ops configuration condition, not a retriable user error). */
+            /** Background job processing is disabled on this API. Agent action: stop; this is a service configuration condition, not a retriable caller error. */
             "jobrunr_disabled",
             /** A catalog task step names an operation this API instance's command catalog does not expose, so its plan cannot be projected. Causes include rollout skew, configuration or a removed operation. Agent action: have an operator check the selected task catalog and deployed operation list before retrying; do not assume a rollout will restore it. */
             "task_plan_operation_unserved",
-            /** JobRunr storage (Postgres) is down. Agent action: stop until it recovers. */
+            /** Background job storage is down. Agent action: stop until it recovers. */
             "JOBRUNR_STORAGE_UNAVAILABLE",
-            /** JobRunr storage (Postgres) is down. Agent action: stop until it recovers. */
+            /** Background job storage is down. Agent action: stop until it recovers. */
             "jobrunr_storage_unavailable",
-            /** RBAC role lookup failed (app_user read did not return). Agent action: retry once; persistent failure indicates a database outage. */
+            /** Account role lookup failed. Agent action: retry once; persistent failure indicates a service outage. */
             "rbac_lookup_unavailable",
-            /** Geocoding provider (Google Maps Platform) call failed. Agent action: surface the error; address fields can be submitted without normalization as a fallback. */
+            /** Geocoding provider call failed. Agent action: surface the error; address fields can be submitted without normalization as a fallback. */
             "GEOCODE_PROVIDER_ERROR",
-            /** Geocoding provider (Google Maps Platform) call failed. Agent action: surface the error; address fields can be submitted without normalization as a fallback. */
+            /** Geocoding provider call failed. Agent action: surface the error; address fields can be submitted without normalization as a fallback. */
             "geocode_provider_error",
-            /** Sentry API call failed (used by error-triage endpoints). Agent action: surface; Sentry outages do not affect the primary application path. */
-            "sentry_api_error",
-            /** Frontend cache epoch requires the cache invalidation outbox consumer to run in targeted mode. Agent action: stop polling; this 503 is a designed cutover guard, and only the operator switching the outbox mode to targeted (docs/database/cache-invalidation.md) makes the epoch readable. */
-            "frontend_cache_epoch_mode_not_targeted",
             /** Image is blocklisted; follow ProblemDetail.hint, never resend it. */
             "image_blocklist_match",
             /** Image is blank or monochrome; follow ProblemDetail.hint, never resend it. */
@@ -152,19 +148,19 @@ export const ProblemDetailSchema = z.object({
             "callback_challenge_failed",
             /** Caller already holds the maximum number of news subscriptions. Agent action: unsubscribe one before subscribing again. */
             "news_subscription_limit",
-            /** Cloudflare R2 object fetch failed during a read operation. Agent action: retry once with backoff; persistent failure indicates R2 outage or asset deletion. */
+            /** Stored object fetch failed during a read operation. Agent action: retry once with backoff; persistent failure indicates a storage outage or asset deletion. */
             "r2_fetch_failed",
-            /** Cloudflare R2 object delete failed during a cleanup operation. Agent action: surface; retrying may produce duplicate-delete errors. */
+            /** Stored object delete failed during a cleanup operation. Agent action: surface; retrying may produce duplicate-delete errors. */
             "r2_delete_failed",
-            /** Cloudflare R2 object upload failed during a write operation. Agent action: retry once with the same payload; persistent failure indicates R2 outage. */
+            /** Stored object upload failed during a write operation. Agent action: retry once with the same payload; persistent failure indicates a storage outage. */
             "r2_upload_failed",
-            /** Stored source-document raw bytes could not be served: the row's inline-or-R2 raw authority is incomplete or failed digest verification. Agent action: surface; the stored authority needs operator reconciliation before this body can be read. */
+            /** Stored source-document raw bytes could not be served: the stored copy is incomplete or failed digest verification. Agent action: surface; aVenture must repair the stored copy before this body can be read. */
             "source_document_body_unavailable",
             /** A source-document capture stopped before retaining a provider response over this service's configured byte limit. Agent action: this is a designed containment boundary, not a provider outage or a service defect; do not retry the same request expecting a different outcome. */
             "source_document_capture_limit_exceeded",
             /** News similarity cannot run because the target embedding is unavailable or live similarity capacity is full. Agent action: surface the 503 and retry later; this endpoint does not fall back to lexical ranking. */
             "news_similarity_embedding_unavailable",
-            /** The web search provider is not configured for this environment. Agent action: stop; admin/ops must configure the provider key before this endpoint succeeds. */
+            /** Web search is not configured on this API. Agent action: stop; retrying cannot succeed until aVenture restores it. */
             "search_provider_not_configured",
             /** Search provider call failed. Agent action: inspect detail and source. Provider credential or credit refusals (401, 402, or 407) are terminal: restore the provider credential or credits first. TERMINAL means refused or already retried: record the outage, never resend. TRANSIENT: retry once per Retry-After. */
             "search_provider_error",
@@ -176,9 +172,9 @@ export const ProblemDetailSchema = z.object({
             "sec_edgar_fetch_failed",
             /** GitHub repository fetch failed (account, listing, or single repo). Agent action: surface; GitHub outages or rate limiting affect github-repo sync endpoints only. */
             "github_fetch_failed",
-            /** Clerk M2M token API failed. Agent action: retry after retryAfterSeconds. */
+            /** Machine-token sign-in service failed. Agent action: retry after retryAfterSeconds. */
             "clerk_m2m_unavailable",
-            /** Clerk OAuth API failed. Agent action: retry after retryAfterSeconds. */
+            /** OAuth sign-in service failed. Agent action: retry after retryAfterSeconds. */
             "clerk_oauth_unavailable",
             /** Researchly usage API failed. Agent action: retry after retryAfterSeconds. */
             "researchly_usage_unavailable",
@@ -194,13 +190,13 @@ export const ProblemDetailSchema = z.object({
             "INFERENCE_PROVIDER_INVALID_JSON",
             /** LLM inference provider returned a response that failed JSON parsing. Agent action: surface; the prompt or response schema may need adjustment. */
             "inference_provider_invalid_json",
-            /** Inference profile catalog is missing or empty. Agent action: stop; admin/ops must configure inference profiles before this endpoint will succeed. */
+            /** Language-model configuration is missing. Agent action: stop; retrying cannot succeed until aVenture restores it. */
             "INFERENCE_PROFILES_MISSING",
-            /** Inference profile catalog is missing or empty. Agent action: stop; admin/ops must configure inference profiles before this endpoint will succeed. */
+            /** Language-model configuration is missing. Agent action: stop; retrying cannot succeed until aVenture restores it. */
             "inference_profiles_missing",
-            /** Inference profile is configured but its API key is missing from secret storage. Agent action: stop; admin/ops must populate the API key in secret storage. */
+            /** Language-model credentials are missing. Agent action: stop; retrying cannot succeed until aVenture restores them. */
             "INFERENCE_PROFILE_API_KEY_MISSING",
-            /** Inference profile is configured but its API key is missing from secret storage. Agent action: stop; admin/ops must populate the API key in secret storage. */
+            /** Language-model credentials are missing. Agent action: stop; retrying cannot succeed until aVenture restores them. */
             "inference_profile_api_key_missing",
         ]),
         z.string().max(128),
@@ -242,8 +238,6 @@ export const ProblemDetailSchema = z.object({
             "IP",
             /** A request-rate limit refused the request; retry after retryAfterSeconds. */
             "UNKNOWN",
-            /** The service is handling too many requests at once; retry after a short backoff. */
-            "RESILIENCE4J",
             /** Too many live web searches; retry after retryAfterSeconds. */
             "WEB_SEARCH",
             /** Too many help questions; retry after retryAfterSeconds. */
@@ -254,14 +248,6 @@ export const ProblemDetailSchema = z.object({
             "BILLING_ALLOWANCE",
             /** The additional-usage spend cap or prepaid credit is used up, counted in cents: stop rather than retry until the cap is raised or credit is added. */
             "BILLING_ADDITIONAL_USAGE",
-            /** Too many command-line sign-in requests; retry after retryAfterSeconds. */
-            "CLERK_PUBLIC_ADMISSION",
-            /** Too many sign-in page load reports; retry after retryAfterSeconds. */
-            "CLERK_SCRIPT_LOAD",
-            /** Not currently sent. If seen, retry after retryAfterSeconds. */
-            "ORIGIN_DETAIL",
-            /** A model service this request depends on is at capacity; retry after retryAfterSeconds. */
-            "INFERENCE_PROVIDER",
         ]),
         z.string(),
     ])

package/dist/natural/search.d.ts

@@ -28,7 +28,6 @@ declare const NaturalSearchSchemaDefinition: z.ZodObject<{
         };
     }>>;
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    modelCatalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     query: z.ZodString;
     reasoningEffort: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
         high: "high";
@@ -47,8 +46,6 @@ declare const NaturalSearchSchemaDefinition: z.ZodObject<{
             xhigh: "xhigh";
         };
     }>>;
-    searchCatalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
-    tenantPolicyRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;
 type NaturalSearchDefinition = z.infer<typeof NaturalSearchSchemaDefinition>;
 export interface NaturalSearchSchemaInput extends z.input<typeof NaturalSearchSchemaDefinition> {

package/dist/natural/search.js

@@ -15,16 +15,10 @@ const NaturalSearchSchemaDefinition = z.object({
     mode: SearchModeSchema.default("auto").optional(),
     /** Optional supported model id for planning the search. Leave the field out for the server's model; a value that is not a supported model id answers 422. */
     model: z.string().nullish(),
-    /** Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
-    modelCatalogRevision: z.int().nullish(),
     /** Plain-English search request. */
     query: z.string().min(1),
     /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. */
     reasoningEffort: ReasoningEffortSchema.nullish(),
-    /** Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
-    searchCatalogRevision: z.int().nullish(),
-    /** Runtime policy revision this search uses for the serving deployment's execution budgets; null reads that deployment's current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
-    tenantPolicyRevision: z.int().nullish(),
 });
 /**
  * Plain-English search request. The server turns the query into a filter and sort for the target record type, then runs that type's standard list search.

package/dist/openapi-component-manifest.js

@@ -1307,6 +1307,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "sort/order-person-sort-field",
         schemaName: "SortOrderPersonSortFieldSchema",
     },
+    SourceDocumentEvidenceView: {
+        modulePath: "source/document-evidence-view",
+        schemaName: "SourceDocumentEvidenceViewSchema",
+    },
     SourceDocumentList: {
         modulePath: "source/document-list",
         schemaName: "SourceDocumentListSchema",

package/dist/pagination/schemas.d.ts

@@ -14595,15 +14595,15 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
             "claude-agent-sdk": "claude-agent-sdk";
             "pi-agent-sdk": "pi-agent-sdk";
         }>>>;
-        chassisRouted: z.ZodBoolean;
+        chassisRouted: z.ZodOptional<z.ZodBoolean>;
         createdAt: z.ZodISODateTime;
         entitySlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        environment: z.ZodEnum<{
+        environment: z.ZodOptional<z.ZodEnum<{
             development: "development";
             production: "production";
             staging: "staging";
             unassigned: "unassigned";
-        }>;
+        }>>;
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         execution: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
             DIRECT: "DIRECT";
@@ -14645,8 +14645,8 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
             "openai-chat": "openai-chat";
             "openai-responses": "openai-responses";
         }>>>;
-        maxIteration: z.ZodInt;
-        maxScoutConcurrent: z.ZodInt;
+        maxIteration: z.ZodOptional<z.ZodInt>;
+        maxScoutConcurrent: z.ZodOptional<z.ZodInt>;
         mode: z.ZodEnum<{
             COMPREHENSIVE: "COMPREHENSIVE";
             INDIVIDUAL: "INDIVIDUAL";

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

@@ -534,22 +534,16 @@ declare const PersonNaturalSearchSchemaDefinition: z.ZodObject<{
         freshness?: "auto" | "cached" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;
-        modelCatalogRevision?: number | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
-        searchCatalogRevision?: number | null | undefined;
-        tenantPolicyRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput, z.core.$ZodTypeInternals<{
         answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
         freshness?: "auto" | "cached" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;
-        modelCatalogRevision?: number | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
-        searchCatalogRevision?: number | null | undefined;
-        tenantPolicyRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput>>;
 }, z.core.$strip>;
 type PersonNaturalSearchDefinition = z.infer<typeof PersonNaturalSearchSchemaDefinition>;

package/dist/problem/type.d.ts

@@ -28,13 +28,6 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     readonly UNEXPECTED_ERROR: "https://api.aventure.vc/errors/unexpected-error";
     readonly NOT_IMPLEMENTED: "https://api.aventure.vc/errors/not-implemented";
     readonly AUTHENTICATION_REQUIRED: "https://api.aventure.vc/errors/authentication-required";
-    readonly AUTH_DOCS_REQUIRED: "https://api.aventure.vc/errors/auth.docs-required";
-    readonly AUTH_ADMIN_KEY_NOT_CONFIGURED: "https://api.aventure.vc/errors/auth.admin-key-not-configured";
-    readonly AUTH_EMPTY_ADMIN_KEY: "https://api.aventure.vc/errors/auth.empty-admin-key";
-    readonly AUTH_EMPTY_ADMIN_BEARER: "https://api.aventure.vc/errors/auth.empty-admin-bearer";
-    readonly AUTH_INVALID_ADMIN_KEY: "https://api.aventure.vc/errors/auth.invalid-admin-key";
-    readonly AUTH_MISSING_ADMIN_KEY: "https://api.aventure.vc/errors/auth.missing-admin-key";
-    readonly AUTH_METRICS_UNAUTHORIZED: "https://api.aventure.vc/errors/auth.metrics-unauthorized";
     readonly ACCESS_DENIED: "https://api.aventure.vc/errors/access-denied";
     readonly NOT_FOUND: "https://api.aventure.vc/errors/not-found";
     readonly ENDPOINT_NOT_FOUND: "https://api.aventure.vc/errors/endpoint-not-found";
@@ -93,13 +86,6 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         readonly UNEXPECTED_ERROR: "https://api.aventure.vc/errors/unexpected-error";
         readonly NOT_IMPLEMENTED: "https://api.aventure.vc/errors/not-implemented";
         readonly AUTHENTICATION_REQUIRED: "https://api.aventure.vc/errors/authentication-required";
-        readonly AUTH_DOCS_REQUIRED: "https://api.aventure.vc/errors/auth.docs-required";
-        readonly AUTH_ADMIN_KEY_NOT_CONFIGURED: "https://api.aventure.vc/errors/auth.admin-key-not-configured";
-        readonly AUTH_EMPTY_ADMIN_KEY: "https://api.aventure.vc/errors/auth.empty-admin-key";
-        readonly AUTH_EMPTY_ADMIN_BEARER: "https://api.aventure.vc/errors/auth.empty-admin-bearer";
-        readonly AUTH_INVALID_ADMIN_KEY: "https://api.aventure.vc/errors/auth.invalid-admin-key";
-        readonly AUTH_MISSING_ADMIN_KEY: "https://api.aventure.vc/errors/auth.missing-admin-key";
-        readonly AUTH_METRICS_UNAUTHORIZED: "https://api.aventure.vc/errors/auth.metrics-unauthorized";
         readonly ACCESS_DENIED: "https://api.aventure.vc/errors/access-denied";
         readonly NOT_FOUND: "https://api.aventure.vc/errors/not-found";
         readonly ENDPOINT_NOT_FOUND: "https://api.aventure.vc/errors/endpoint-not-found";

package/dist/problem/type.js

@@ -20,13 +20,6 @@ const ProblemTypeSchemaKnownMembers = z.enum({
     UNEXPECTED_ERROR: "https://api.aventure.vc/errors/unexpected-error",
     NOT_IMPLEMENTED: "https://api.aventure.vc/errors/not-implemented",
     AUTHENTICATION_REQUIRED: "https://api.aventure.vc/errors/authentication-required",
-    AUTH_DOCS_REQUIRED: "https://api.aventure.vc/errors/auth.docs-required",
-    AUTH_ADMIN_KEY_NOT_CONFIGURED: "https://api.aventure.vc/errors/auth.admin-key-not-configured",
-    AUTH_EMPTY_ADMIN_KEY: "https://api.aventure.vc/errors/auth.empty-admin-key",
-    AUTH_EMPTY_ADMIN_BEARER: "https://api.aventure.vc/errors/auth.empty-admin-bearer",
-    AUTH_INVALID_ADMIN_KEY: "https://api.aventure.vc/errors/auth.invalid-admin-key",
-    AUTH_MISSING_ADMIN_KEY: "https://api.aventure.vc/errors/auth.missing-admin-key",
-    AUTH_METRICS_UNAUTHORIZED: "https://api.aventure.vc/errors/auth.metrics-unauthorized",
     ACCESS_DENIED: "https://api.aventure.vc/errors/access-denied",
     NOT_FOUND: "https://api.aventure.vc/errors/not-found",
     ENDPOINT_NOT_FOUND: "https://api.aventure.vc/errors/endpoint-not-found",

package/dist/research/finding.d.ts

@@ -1,6 +1,15 @@
 import { z } from "zod/v4";
 declare const ResearchFindingSchemaDefinition: z.ZodObject<{
     end: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    evidenceView: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        ARTICLE_V1: "ARTICLE_V1";
+        LEGACY: "LEGACY";
+    }>, z.ZodString]> & {
+        enum: {
+            ARTICLE_V1: "ARTICLE_V1";
+            LEGACY: "LEGACY";
+        };
+    }>>;
     gateId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     quote: z.ZodOptional<z.ZodString>;
     sourceDocumentId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;

package/dist/research/finding.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 { SourceDocumentEvidenceViewSchema } from "../source/document-evidence-view.js";
 import { WriterClaimSurfaceSchema } from "../writer/claim-surface.js";
 const ResearchFindingSchemaDefinition = z.object({
     /** Exclusive UTF-16 end offset, as an entity folio fact's end. */
     end: z.int().nullish(),
+    /** Evidence view returned with the folio span; omitted values retain LEGACY offsets. Copy this value with sourceDocumentId, start and end. */
+    evidenceView: SourceDocumentEvidenceViewSchema.nullish(),
     /** Profile field the fact fills, when known; omit it and the run picks the field the fact belongs to. */
     gateId: z.string().nullish(),
     /** The exact text on sourceUrl that states the fact, copied verbatim; a fragment short enough to appear on any page is refused. Send either quote or the complete sourceDocumentId, start, end span, never both. */

package/dist/source/document-evidence-view.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+/**
+ * Captured-text representation: LEGACY preserves existing offsets; ARTICLE_V1 reads the captured article without page controls.
+ *
+ * @openapiSchema SourceDocumentEvidenceView
+ * @endpoint GET /v1/research/runs/{runId}/draft
+ * @endpoint GET /v1/research/runs/{runId}/draft/sections/{sectionKey}/writes/{writeId}
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/research/runs
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisCitationSchema
+ * @usedBySchema ResearchFindingSchema
+ * @contractShape source.document-evidence-view
+ * @contractRole canonical
+ */
+export declare const SourceDocumentEvidenceViewSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    ARTICLE_V1: "ARTICLE_V1";
+    LEGACY: "LEGACY";
+}>, z.ZodString]> & {
+    enum: {
+        ARTICLE_V1: "ARTICLE_V1";
+        LEGACY: "LEGACY";
+    };
+};
+export type SourceDocumentEvidenceView = z.infer<typeof SourceDocumentEvidenceViewSchema>;
+//# sourceMappingURL=document-evidence-view.d.ts.map

package/dist/source/document-evidence-view.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";
+const SourceDocumentEvidenceViewSchemaKnownMembers = z.enum(["LEGACY", "ARTICLE_V1"]);
+/**
+ * Captured-text representation: LEGACY preserves existing offsets; ARTICLE_V1 reads the captured article without page controls.
+ *
+ * @openapiSchema SourceDocumentEvidenceView
+ * @endpoint GET /v1/research/runs/{runId}/draft
+ * @endpoint GET /v1/research/runs/{runId}/draft/sections/{sectionKey}/writes/{writeId}
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/research/runs
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisCitationSchema
+ * @usedBySchema ResearchFindingSchema
+ * @contractShape source.document-evidence-view
+ * @contractRole canonical
+ */
+export const SourceDocumentEvidenceViewSchema = Object.assign(z.union([SourceDocumentEvidenceViewSchemaKnownMembers, z.string()]), { enum: SourceDocumentEvidenceViewSchemaKnownMembers.enum });
+//# sourceMappingURL=document-evidence-view.js.map

package/dist/writer/brief.d.ts

@@ -13,6 +13,7 @@ import { z } from "zod/v4";
 export declare const WriterBriefSchema: z.ZodObject<{
     claim: z.ZodArray<z.ZodType<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;
@@ -22,6 +23,7 @@ export declare const WriterBriefSchema: z.ZodObject<{
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         end?: number | null | undefined;
+        evidenceView?: string | null | undefined;
         gateId?: string | null | undefined;
         quote?: string | undefined;
         sourceDocumentId?: string | null | undefined;

package/package.json

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