@aventurevc/api-schemas 0.8.262 → 0.8.263

package/dist/enrichment/enrichment.d.ts

@@ -61,6 +61,7 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
             INDIVIDUAL: "INDIVIDUAL";
         }>;
         model: z.ZodString;
+        modelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         nextAttemptAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         researchAllowanceType: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
             COMPANY: "COMPANY";
@@ -89,6 +90,7 @@ declare const EnrichmentSchemaDefinition: z.ZodObject<{
             stopped: "stopped";
         }>;
         subagentModel: z.ZodString;
+        subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
         type: z.ZodEnum<{
             ENRICHMENT: "ENRICHMENT";

package/dist/enrichment/prompt.d.ts

@@ -1,15 +1,21 @@
 import { z } from "zod/v4";
 declare const EnrichmentPromptSchemaDefinition: z.ZodObject<{
     finding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        end?: number | null | undefined;
         gateId?: string | null | undefined;
-        quote: string;
+        quote?: string | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
+        start?: number | null | undefined;
         statement: string;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
+        end?: number | null | undefined;
         gateId?: string | null | undefined;
-        quote: string;
+        quote?: string | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
+        start?: number | null | undefined;
         statement: string;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>>>;

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

@@ -50,15 +50,21 @@ declare const EntityAnalysisSectionMutationSchemaDefinition: z.ZodObject<{
     title: z.ZodString;
     writerBrief: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         claim: z.ZodArray<z.ZodType<{
+            end?: number | null | undefined;
             gateId?: string | null | undefined;
-            quote: string;
+            quote?: string | undefined;
+            sourceDocumentId?: string | null | undefined;
             sourceUrl: string;
+            start?: number | null | undefined;
             statement: string;
             writerSurface?: string | null | undefined;
         }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
+            end?: number | null | undefined;
             gateId?: string | null | undefined;
-            quote: string;
+            quote?: string | undefined;
+            sourceDocumentId?: string | null | undefined;
             sourceUrl: string;
+            start?: number | null | undefined;
             statement: string;
             writerSurface?: string | null | undefined;
         }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;

package/dist/entity/text.d.ts

@@ -7,6 +7,7 @@ declare const EntityTextSchemaDefinition: z.ZodObject<{
         wordCount: z.ZodInt;
     }, z.core.$strip>>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    expandedTextId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     id: z.ZodInt;
     isCurrent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     isPrimary: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/entity/text.js

@@ -6,6 +6,8 @@ const EntityTextSchemaDefinition = z.object({
     /** Derived character/word counts and governed-contract compliance for this text row; null when not evaluated. */
     compliance: ContentComplianceSchema.nullish(),
     createdAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Id of the expanded row a summary create wrote in the same transaction from expandedWriterBrief; read it at GET /v1/entities/{entityId}/texts/{textId}. Null on every other response. */
+    expandedTextId: z.int().nullish(),
     /** Type-safe identifier for text records */
     id: z.int(),
     /** Whether this is the owner's current text of its textType; setting it clears the flag on the owner's other texts of that type. */

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

@@ -1,15 +1,21 @@
 import { z } from "zod/v4";
 declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
     finding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        end?: number | null | undefined;
         gateId?: string | null | undefined;
-        quote: string;
+        quote?: string | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
+        start?: number | null | undefined;
         statement: string;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
+        end?: number | null | undefined;
         gateId?: string | null | undefined;
-        quote: string;
+        quote?: string | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
+        start?: number | null | undefined;
         statement: string;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>>>;

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

@@ -210,6 +210,7 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
             INDIVIDUAL: "INDIVIDUAL";
         }>;
         model: z.ZodString;
+        modelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         nextAttemptAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         researchAllowanceType: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
             COMPANY: "COMPANY";
@@ -238,6 +239,7 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
             stopped: "stopped";
         }>;
         subagentModel: z.ZodString;
+        subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
         type: z.ZodEnum<{
             ENRICHMENT: "ENRICHMENT";

package/dist/harness/run.d.ts

@@ -62,6 +62,7 @@ export declare const HarnessRunSchema: z.ZodObject<{
         INDIVIDUAL: "INDIVIDUAL";
     }>;
     model: z.ZodString;
+    modelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     nextAttemptAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     researchAllowanceType: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
         COMPANY: "COMPANY";
@@ -90,6 +91,7 @@ export declare const HarnessRunSchema: z.ZodObject<{
         stopped: "stopped";
     }>;
     subagentModel: z.ZodString;
+    subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     type: z.ZodEnum<{
         ENRICHMENT: "ENRICHMENT";

package/dist/harness/run.js

@@ -69,6 +69,8 @@ export const HarnessRunSchema = z.object({
     mode: EnrichmentModeSchema,
     /** Model the run uses */
     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(),
     /** Earliest re-claim time when waiting on retry backoff */
     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 */
@@ -81,6 +83,8 @@ export const HarnessRunSchema = z.object({
     status: HarnessRunStatusSchema,
     /** Read-only research, cohort, and completion sub-agent model id */
     subagentModel: z.string(),
+    /** 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 */
+    subagentModelRouted: z.boolean().nullish(),
     /** Research presets filed with the run */
     taskPresetKey: z.array(z.string()).nullish(),
     /** Run kind: ENRICHMENT for a research request a caller filed, TASK for a narrower run aVenture scheduled */

package/dist/pagination/schemas.d.ts

@@ -11233,6 +11233,7 @@ declare const PageEntityTextSchemaDefinition: z.ZodObject<{
             wordCount: number;
         } | null | undefined;
         createdAt?: string | null | undefined;
+        expandedTextId?: number | null | undefined;
         id: number;
         isCurrent?: boolean | null | undefined;
         isPrimary?: boolean | null | undefined;
@@ -11253,6 +11254,7 @@ declare const PageEntityTextSchemaDefinition: z.ZodObject<{
             wordCount: number;
         } | null | undefined;
         createdAt?: string | null | undefined;
+        expandedTextId?: number | null | undefined;
         id: number;
         isCurrent?: boolean | null | undefined;
         isPrimary?: boolean | null | undefined;
@@ -11578,6 +11580,7 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
             INDIVIDUAL: "INDIVIDUAL";
         }>;
         model: z.ZodString;
+        modelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         nextAttemptAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         researchAllowanceType: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
             COMPANY: "COMPANY";
@@ -11606,6 +11609,7 @@ declare const PageHarnessRunSchemaDefinition: z.ZodObject<{
             stopped: "stopped";
         }>;
         subagentModel: z.ZodString;
+        subagentModelRouted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
         type: z.ZodEnum<{
             ENRICHMENT: "ENRICHMENT";

package/dist/research/finding.d.ts

@@ -1,8 +1,11 @@
 import { z } from "zod/v4";
 declare const ResearchFindingSchemaDefinition: z.ZodObject<{
+    end: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     gateId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    quote: z.ZodString;
+    quote: z.ZodOptional<z.ZodString>;
+    sourceDocumentId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     sourceUrl: z.ZodString;
+    start: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     statement: z.ZodString;
     writerSurface: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
         BOTH: "BOTH";

package/dist/research/finding.js

@@ -2,12 +2,18 @@
 import { z } from "zod/v4";
 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(),
     /** 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. */
-    quote: z.string(),
+    /** 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. */
+    quote: z.string().optional(),
+    /** Writer briefs only: the stored capture a span cites instead of a retyped quote, such as an entity folio fact's sourceDocumentId; the server copies the quote from [start, end) of that capture's evidence text. Requester findings require quote. */
+    sourceDocumentId: z.uuid().nullish(),
     /** Absolute http or https URL of the page that supports the fact; aVenture pages are refused. Direct writes require a resolved sourceDetail page and may supplement it with eligible pages associated with the subject or explicitly bound through sourceDocumentId on a pending full create; harness-run writes use the sourceDetail page or eligible pages read through aVenture by the authorizing run. Each quote must occur in its page's stored text. */
     sourceUrl: z.string(),
+    /** Inclusive UTF-16 start offset, as an entity folio fact's start. */
+    start: z.int().nullish(),
     /** The fact to write, in plain words. */
     statement: z.string(),
     /** Surface this sourced claim may enter: durable entity text, point-in-time research snippets, or both. New writer briefs must declare it. */

package/dist/writer/brief.d.ts

@@ -11,15 +11,21 @@ import { z } from "zod/v4";
  */
 export declare const WriterBriefSchema: z.ZodObject<{
     claim: z.ZodArray<z.ZodType<{
+        end?: number | null | undefined;
         gateId?: string | null | undefined;
-        quote: string;
+        quote?: string | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
+        start?: number | null | undefined;
         statement: string;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
+        end?: number | null | undefined;
         gateId?: string | null | undefined;
-        quote: string;
+        quote?: string | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
+        start?: number | null | undefined;
         statement: string;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;

package/package.json

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