@aventurevc/api-schemas 0.8.262 → 0.8.264

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-activity-type.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod/v4";
+/**
+ * Reader-facing activity category
+ *
+ * @openapiSchema HarnessRunActivityType
+ * @endpoint GET /v1/research/runs/{runId}/events
+ * @usedBySchema HarnessRunActivitySchema
+ * @contractShape harness.run-activity-type
+ * @contractRole canonical
+ */
+export declare const HarnessRunActivityTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    CHECK: "CHECK";
+    FINISHED: "FINISHED";
+    QUEUED: "QUEUED";
+    READ: "READ";
+    SEARCH: "SEARCH";
+    STARTED: "STARTED";
+    WRITE: "WRITE";
+}>, z.ZodString]> & {
+    enum: {
+        CHECK: "CHECK";
+        FINISHED: "FINISHED";
+        QUEUED: "QUEUED";
+        READ: "READ";
+        SEARCH: "SEARCH";
+        STARTED: "STARTED";
+        WRITE: "WRITE";
+    };
+};
+export type HarnessRunActivityType = z.infer<typeof HarnessRunActivityTypeSchema>;
+//# sourceMappingURL=run-activity-type.d.ts.map

package/dist/harness/run-activity-type.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 HarnessRunActivityTypeSchemaKnownMembers = z.enum([
+    "QUEUED",
+    "STARTED",
+    "SEARCH",
+    "READ",
+    "CHECK",
+    "WRITE",
+    "FINISHED",
+]);
+/**
+ * Reader-facing activity category
+ *
+ * @openapiSchema HarnessRunActivityType
+ * @endpoint GET /v1/research/runs/{runId}/events
+ * @usedBySchema HarnessRunActivitySchema
+ * @contractShape harness.run-activity-type
+ * @contractRole canonical
+ */
+export const HarnessRunActivityTypeSchema = Object.assign(z.union([HarnessRunActivityTypeSchemaKnownMembers, z.string()]), { enum: HarnessRunActivityTypeSchemaKnownMembers.enum });
+//# sourceMappingURL=run-activity-type.js.map

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

@@ -0,0 +1,40 @@
+import { z } from "zod/v4";
+declare const HarnessRunActivitySchemaDefinition: z.ZodObject<{
+    createdAt: z.ZodISODateTime;
+    kind: z.ZodUnion<readonly [z.ZodEnum<{
+        CHECK: "CHECK";
+        FINISHED: "FINISHED";
+        QUEUED: "QUEUED";
+        READ: "READ";
+        SEARCH: "SEARCH";
+        STARTED: "STARTED";
+        WRITE: "WRITE";
+    }>, z.ZodString]> & {
+        enum: {
+            CHECK: "CHECK";
+            FINISHED: "FINISHED";
+            QUEUED: "QUEUED";
+            READ: "READ";
+            SEARCH: "SEARCH";
+            STARTED: "STARTED";
+            WRITE: "WRITE";
+        };
+    };
+    label: z.ZodString;
+    seq: z.ZodInt;
+}, z.core.$strip>;
+type HarnessRunActivityDefinition = z.infer<typeof HarnessRunActivitySchemaDefinition>;
+export interface HarnessRunActivitySchemaInput extends z.input<typeof HarnessRunActivitySchemaDefinition> {
+}
+/**
+ * One ordered reader-facing run activity
+ *
+ * @openapiSchema HarnessRunActivity
+ * @endpoint GET /v1/research/runs/{runId}/events
+ * @contractShape harness.run-activity
+ * @contractRole canonical
+ */
+export declare const HarnessRunActivitySchema: z.ZodType<HarnessRunActivityDefinition, HarnessRunActivitySchemaInput>;
+export type HarnessRunActivity = z.infer<typeof HarnessRunActivitySchema>;
+export {};
+//# sourceMappingURL=run-activity.d.ts.map

package/dist/harness/run-activity.js

@@ -0,0 +1,23 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { HarnessRunActivityTypeSchema } from "./run-activity-type.js";
+const HarnessRunActivitySchemaDefinition = z.object({
+    /** Time of the underlying event */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** Activity category */
+    kind: HarnessRunActivityTypeSchema,
+    /** Reader-facing activity description */
+    label: z.string(),
+    /** Per-run event sequence */
+    seq: z.int(),
+});
+/**
+ * One ordered reader-facing run activity
+ *
+ * @openapiSchema HarnessRunActivity
+ * @endpoint GET /v1/research/runs/{runId}/events
+ * @contractShape harness.run-activity
+ * @contractRole canonical
+ */
+export const HarnessRunActivitySchema = HarnessRunActivitySchemaDefinition;
+//# sourceMappingURL=run-activity.js.map

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/openapi-component-manifest.js

@@ -642,6 +642,14 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     HarnessChassis: { modulePath: "harness/chassis", schemaName: "HarnessChassisSchema" },
     HarnessLlmApi: { modulePath: "harness/llm-api", schemaName: "HarnessLlmApiSchema" },
     HarnessRun: { modulePath: "harness/run", schemaName: "HarnessRunSchema" },
+    HarnessRunActivity: {
+        modulePath: "harness/run-activity",
+        schemaName: "HarnessRunActivitySchema",
+    },
+    HarnessRunActivityType: {
+        modulePath: "harness/run-activity-type",
+        schemaName: "HarnessRunActivityTypeSchema",
+    },
     HarnessRunCreate: { modulePath: "harness/run-create", schemaName: "HarnessRunCreateSchema" },
     HarnessRunDetail: { modulePath: "harness/run-detail", schemaName: "HarnessRunDetailSchema" },
     HarnessRunEnvironment: {

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.264",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",