@aventurevc/api-schemas 0.8.263 → 0.8.265

package/dist/enrichment/prompt.d.ts

@@ -7,7 +7,7 @@ declare const EnrichmentPromptSchemaDefinition: z.ZodObject<{
         sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
         start?: number | null | undefined;
-        statement: string;
+        statement?: string | undefined;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         end?: number | null | undefined;
@@ -16,7 +16,7 @@ declare const EnrichmentPromptSchemaDefinition: z.ZodObject<{
         sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
         start?: number | null | undefined;
-        statement: string;
+        statement?: string | undefined;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>>>;
     userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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

@@ -56,7 +56,7 @@ declare const EntityAnalysisSectionMutationSchemaDefinition: z.ZodObject<{
             sourceDocumentId?: string | null | undefined;
             sourceUrl: string;
             start?: number | null | undefined;
-            statement: string;
+            statement?: string | undefined;
             writerSurface?: string | null | undefined;
         }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
             end?: number | null | undefined;
@@ -65,7 +65,7 @@ declare const EntityAnalysisSectionMutationSchemaDefinition: z.ZodObject<{
             sourceDocumentId?: string | null | undefined;
             sourceUrl: string;
             start?: number | null | undefined;
-            statement: string;
+            statement?: string | undefined;
             writerSurface?: string | null | undefined;
         }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;
         metaAnalysis: z.ZodOptional<z.ZodObject<{

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>>;
+    expandedText: z.ZodOptional<z.ZodNullable<z.ZodObject</*elided*/ any, z.core.$strip>>>;
     expandedTextId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     id: z.ZodInt;
     isCurrent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/entity/text.js

@@ -6,6 +6,10 @@ 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(),
+    /** Expanded row written with this summary by expandedWriterBrief, including its compliance. Null when this response does not represent a paired create. */
+    get expandedText() {
+        return EntityTextSchemaDefinition.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 */

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

@@ -7,7 +7,7 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
         start?: number | null | undefined;
-        statement: string;
+        statement?: string | undefined;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         end?: number | null | undefined;
@@ -16,7 +16,7 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
         start?: number | null | undefined;
-        statement: string;
+        statement?: string | undefined;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>>>;
     mode: z.ZodOptional<z.ZodEnum<{

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,29 @@ declare const PageEntityTextSchemaDefinition: z.ZodObject<{
             wordCount: number;
         } | null | undefined;
         createdAt?: string | null | undefined;
+        expandedText?: {
+            compliance?: {
+                characterCount: number;
+                meetsRequirements: boolean;
+                violation: string[];
+                wordCount: number;
+            } | null | undefined;
+            createdAt?: string | null | undefined;
+            expandedText?: /*elided*/ any | null | undefined;
+            expandedTextId?: number | null | undefined;
+            id: number;
+            isCurrent?: boolean | null | undefined;
+            isPrimary?: boolean | null | undefined;
+            language?: string | null | undefined;
+            owner: {
+                entityId?: string | null | undefined;
+                personId?: string | null | undefined;
+            };
+            text: string;
+            textName?: string | null | undefined;
+            textType: string;
+            updatedAt?: string | null | undefined;
+        } | null | undefined;
         expandedTextId?: number | null | undefined;
         id: number;
         isCurrent?: boolean | null | undefined;
@@ -11254,6 +11277,29 @@ declare const PageEntityTextSchemaDefinition: z.ZodObject<{
             wordCount: number;
         } | null | undefined;
         createdAt?: string | null | undefined;
+        expandedText?: {
+            compliance?: {
+                characterCount: number;
+                meetsRequirements: boolean;
+                violation: string[];
+                wordCount: number;
+            } | null | undefined;
+            createdAt?: string | null | undefined;
+            expandedText?: any | null | undefined;
+            expandedTextId?: number | null | undefined;
+            id: number;
+            isCurrent?: boolean | null | undefined;
+            isPrimary?: boolean | null | undefined;
+            language?: string | null | undefined;
+            owner: {
+                entityId?: string | null | undefined;
+                personId?: string | null | undefined;
+            };
+            text: string;
+            textName?: string | null | undefined;
+            textType: string;
+            updatedAt?: string | null | undefined;
+        } | null | undefined;
         expandedTextId?: number | null | undefined;
         id: number;
         isCurrent?: boolean | null | undefined;

package/dist/research/finding.d.ts

@@ -6,7 +6,7 @@ declare const ResearchFindingSchemaDefinition: z.ZodObject<{
     sourceDocumentId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     sourceUrl: z.ZodString;
     start: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
-    statement: z.ZodString;
+    statement: z.ZodOptional<z.ZodString>;
     writerSurface: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
         BOTH: "BOTH";
         ENTITY_TEXT: "ENTITY_TEXT";

package/dist/research/finding.js

@@ -14,8 +14,8 @@ const ResearchFindingSchemaDefinition = z.object({
     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(),
+    /** The fact to write, in plain words. May be omitted for a complete sourceDocumentId, start, end span; the server uses that span's exact stored text as the statement. */
+    statement: z.string().optional(),
     /** Surface this sourced claim may enter: durable entity text, point-in-time research snippets, or both. New writer briefs must declare it. */
     writerSurface: WriterClaimSurfaceSchema.nullish(),
 });

package/dist/writer/brief.d.ts

@@ -17,7 +17,7 @@ export declare const WriterBriefSchema: z.ZodObject<{
         sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
         start?: number | null | undefined;
-        statement: string;
+        statement?: string | undefined;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         end?: number | null | undefined;
@@ -26,7 +26,7 @@ export declare const WriterBriefSchema: z.ZodObject<{
         sourceDocumentId?: string | null | undefined;
         sourceUrl: string;
         start?: number | null | undefined;
-        statement: string;
+        statement?: string | undefined;
         writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;
     metaAnalysis: z.ZodOptional<z.ZodObject<{

package/package.json

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