@aventurevc/api-schemas 0.8.254 → 0.8.256

package/dist/cursor/slice-harness-run-event.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod/v4";
+declare const CursorSliceHarnessRunEventSchemaDefinition: z.ZodObject<{
+    content: z.ZodArray<z.ZodType<{
+        createdAt: string;
+        id: number;
+        payload: string;
+        runId: string;
+        seq: number;
+        type: string;
+    }, import("../harness/run-event.ts").HarnessRunEventSchemaInput, z.core.$ZodTypeInternals<{
+        createdAt: string;
+        id: number;
+        payload: string;
+        runId: string;
+        seq: number;
+        type: string;
+    }, import("../harness/run-event.ts").HarnessRunEventSchemaInput>>>;
+    nextCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type CursorSliceHarnessRunEventDefinition = z.infer<typeof CursorSliceHarnessRunEventSchemaDefinition>;
+export interface CursorSliceHarnessRunEventSchemaInput extends z.input<typeof CursorSliceHarnessRunEventSchemaDefinition> {
+}
+/**
+ * @openapiSchema CursorSliceHarnessRunEvent
+ * @endpoint GET /v1/research-runs/{runId}/events
+ * @contractShape cursor.slice-harness-run-event
+ * @contractRole canonical
+ */
+export declare const CursorSliceHarnessRunEventSchema: z.ZodType<CursorSliceHarnessRunEventDefinition, CursorSliceHarnessRunEventSchemaInput>;
+export type CursorSliceHarnessRunEvent = z.infer<typeof CursorSliceHarnessRunEventSchema>;
+export {};
+//# sourceMappingURL=slice-harness-run-event.d.ts.map

package/dist/cursor/slice-harness-run-event.js

@@ -0,0 +1,15 @@
+// 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 { HarnessRunEventSchema } from "../harness/run-event.js";
+const CursorSliceHarnessRunEventSchemaDefinition = z.object({
+    content: z.array(HarnessRunEventSchema),
+    nextCursor: z.string().nullish(),
+});
+/**
+ * @openapiSchema CursorSliceHarnessRunEvent
+ * @endpoint GET /v1/research-runs/{runId}/events
+ * @contractShape cursor.slice-harness-run-event
+ * @contractRole canonical
+ */
+export const CursorSliceHarnessRunEventSchema = CursorSliceHarnessRunEventSchemaDefinition;
+//# sourceMappingURL=slice-harness-run-event.js.map

package/dist/enrichment/mode.d.ts

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * Whether the run performs comprehensive enrichment or only selected tasks
  *
  * @openapiSchema EnrichmentMode
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

package/dist/enrichment/mode.js

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  * Whether the run performs comprehensive enrichment or only selected tasks
  *
  * @openapiSchema EnrichmentMode
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

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

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisCitationSchemaDefinition: z.ZodObject<{
+    quote: z.ZodString;
+    sourceDocumentId: z.ZodUUID;
+}, z.core.$strip>;
+type EntityAnalysisCitationDefinition = z.infer<typeof EntityAnalysisCitationSchemaDefinition>;
+export interface EntityAnalysisCitationSchemaInput extends z.input<typeof EntityAnalysisCitationSchemaDefinition> {
+}
+/**
+ * Verbatim evidence from an archived source document.
+ *
+ * @openapiSchema EntityAnalysisCitation
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-citation
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisCitationSchema: z.ZodType<EntityAnalysisCitationDefinition, EntityAnalysisCitationSchemaInput>;
+export type EntityAnalysisCitation = z.infer<typeof EntityAnalysisCitationSchema>;
+export {};
+//# sourceMappingURL=analysis-citation.d.ts.map

package/dist/entity/analysis-citation.js

@@ -0,0 +1,20 @@
+// 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 EntityAnalysisCitationSchemaDefinition = z.object({
+    /** Nonempty verbatim quote to verify against the archived document. */
+    quote: z.string(),
+    /** Canonical archived source document UUID. */
+    sourceDocumentId: z.uuid(),
+});
+/**
+ * Verbatim evidence from an archived source document.
+ *
+ * @openapiSchema EntityAnalysisCitation
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-citation
+ * @contractRole canonical
+ */
+export const EntityAnalysisCitationSchema = EntityAnalysisCitationSchemaDefinition;
+//# sourceMappingURL=analysis-citation.js.map

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

@@ -0,0 +1,71 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisDraftSchemaDefinition: z.ZodObject<{
+    entityId: z.ZodUUID;
+    runId: z.ZodUUID;
+    section: z.ZodArray<z.ZodType<{
+        citation: {
+            quote: string;
+            sourceDocumentId: string;
+        }[];
+        figure?: {
+            column?: string[] | undefined;
+            entry: {
+                cell: {
+                    citation: number;
+                    excerpt: string;
+                }[];
+                label: string;
+            }[];
+            title: string;
+            type: string;
+        }[] | undefined;
+        key: string;
+        origin: string;
+        paragraph: {
+            label?: string | null | undefined;
+            text: string;
+        }[];
+        title: string;
+    }, import("./analysis-section.ts").EntityAnalysisSectionSchemaInput, z.core.$ZodTypeInternals<{
+        citation: {
+            quote: string;
+            sourceDocumentId: string;
+        }[];
+        figure?: {
+            column?: string[] | undefined;
+            entry: {
+                cell: {
+                    citation: number;
+                    excerpt: string;
+                }[];
+                label: string;
+            }[];
+            title: string;
+            type: string;
+        }[] | undefined;
+        key: string;
+        origin: string;
+        paragraph: {
+            label?: string | null | undefined;
+            text: string;
+        }[];
+        title: string;
+    }, import("./analysis-section.ts").EntityAnalysisSectionSchemaInput>>>;
+    version: z.ZodInt;
+}, z.core.$strip>;
+type EntityAnalysisDraftDefinition = z.infer<typeof EntityAnalysisDraftSchemaDefinition>;
+export interface EntityAnalysisDraftSchemaInput extends z.input<typeof EntityAnalysisDraftSchemaDefinition> {
+}
+/**
+ * Private, unverified analysis for one research run.
+ *
+ * @openapiSchema EntityAnalysisDraft
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @contractShape entity.analysis-draft
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisDraftSchema: z.ZodType<EntityAnalysisDraftDefinition, EntityAnalysisDraftSchemaInput>;
+export type EntityAnalysisDraft = z.infer<typeof EntityAnalysisDraftSchema>;
+export {};
+//# sourceMappingURL=analysis-draft.d.ts.map

package/dist/entity/analysis-draft.js

@@ -0,0 +1,24 @@
+// 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 { EntityAnalysisSectionSchema } from "./analysis-section.js";
+const EntityAnalysisDraftSchemaDefinition = z.object({
+    /** Entity researched by this run. */
+    entityId: z.uuid(),
+    /** Run that owns this private draft. */
+    runId: z.uuid(),
+    /** Current sections, each identified by its snippet type key. */
+    section: z.array(EntityAnalysisSectionSchema),
+    /** Latest analysis-section event sequence; zero before the first section. */
+    version: z.int().min(0),
+});
+/**
+ * Private, unverified analysis for one research run.
+ *
+ * @openapiSchema EntityAnalysisDraft
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @contractShape entity.analysis-draft
+ * @contractRole canonical
+ */
+export const EntityAnalysisDraftSchema = EntityAnalysisDraftSchemaDefinition;
+//# sourceMappingURL=analysis-draft.js.map

package/dist/entity/analysis-figure-cell.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisFigureCellSchemaDefinition: z.ZodObject<{
+    citation: z.ZodInt;
+    excerpt: z.ZodString;
+}, z.core.$strip>;
+type EntityAnalysisFigureCellDefinition = z.infer<typeof EntityAnalysisFigureCellSchemaDefinition>;
+export interface EntityAnalysisFigureCellSchemaInput extends z.input<typeof EntityAnalysisFigureCellSchemaDefinition> {
+}
+/**
+ * A verbatim excerpt of one section citation's quote.
+ *
+ * @openapiSchema EntityAnalysisFigureCell
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisFigureEntrySchema
+ * @contractShape entity.analysis-figure-cell
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisFigureCellSchema: z.ZodType<EntityAnalysisFigureCellDefinition, EntityAnalysisFigureCellSchemaInput>;
+export type EntityAnalysisFigureCell = z.infer<typeof EntityAnalysisFigureCellSchema>;
+export {};
+//# sourceMappingURL=analysis-figure-cell.d.ts.map

package/dist/entity/analysis-figure-cell.js

@@ -0,0 +1,20 @@
+// 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 EntityAnalysisFigureCellSchemaDefinition = z.object({
+    /** Position of the cited quote in the section's citation list, from 1. */
+    citation: z.int().min(1),
+    /** Exact text copied from that quote; the figure displays it as is. */
+    excerpt: z.string().min(1).max(200),
+});
+/**
+ * A verbatim excerpt of one section citation's quote.
+ *
+ * @openapiSchema EntityAnalysisFigureCell
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisFigureEntrySchema
+ * @contractShape entity.analysis-figure-cell
+ * @contractRole canonical
+ */
+export const EntityAnalysisFigureCellSchema = EntityAnalysisFigureCellSchemaDefinition;
+//# sourceMappingURL=analysis-figure-cell.js.map

package/dist/entity/analysis-figure-entry.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisFigureEntrySchemaDefinition: z.ZodObject<{
+    cell: z.ZodArray<z.ZodType<{
+        citation: number;
+        excerpt: string;
+    }, import("./analysis-figure-cell.ts").EntityAnalysisFigureCellSchemaInput, z.core.$ZodTypeInternals<{
+        citation: number;
+        excerpt: string;
+    }, import("./analysis-figure-cell.ts").EntityAnalysisFigureCellSchemaInput>>>;
+    label: z.ZodString;
+}, z.core.$strip>;
+type EntityAnalysisFigureEntryDefinition = z.infer<typeof EntityAnalysisFigureEntrySchemaDefinition>;
+export interface EntityAnalysisFigureEntrySchemaInput extends z.input<typeof EntityAnalysisFigureEntrySchemaDefinition> {
+}
+/**
+ * One labeled entry of excerpt cells.
+ *
+ * @openapiSchema EntityAnalysisFigureEntry
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisFigureSchema
+ * @contractShape entity.analysis-figure-entry
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisFigureEntrySchema: z.ZodType<EntityAnalysisFigureEntryDefinition, EntityAnalysisFigureEntrySchemaInput>;
+export type EntityAnalysisFigureEntry = z.infer<typeof EntityAnalysisFigureEntrySchema>;
+export {};
+//# sourceMappingURL=analysis-figure-entry.d.ts.map

package/dist/entity/analysis-figure-entry.js

@@ -0,0 +1,21 @@
+// 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 { EntityAnalysisFigureCellSchema } from "./analysis-figure-cell.js";
+const EntityAnalysisFigureEntrySchemaDefinition = z.object({
+    /** One cell per COMPARISON column; exactly one cell for every other type. */
+    cell: z.array(EntityAnalysisFigureCellSchema),
+    /** Entry heading: the party (COMPARISON), the date as its quote states it (TIMELINE), the step (FLOW), or the measure and period (METRIC). */
+    label: z.string().min(1).max(48),
+});
+/**
+ * One labeled entry of excerpt cells.
+ *
+ * @openapiSchema EntityAnalysisFigureEntry
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisFigureSchema
+ * @contractShape entity.analysis-figure-entry
+ * @contractRole canonical
+ */
+export const EntityAnalysisFigureEntrySchema = EntityAnalysisFigureEntrySchemaDefinition;
+//# sourceMappingURL=analysis-figure-entry.js.map

package/dist/entity/analysis-figure-type.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+/**
+ * Figure layout: COMPARISON matrix of parties by attribute, dated TIMELINE, ordered FLOW of steps, or METRIC key figures.
+ *
+ * @openapiSchema EntityAnalysisFigureType
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisFigureSchema
+ * @contractShape entity.analysis-figure-type
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisFigureTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    COMPARISON: "COMPARISON";
+    FLOW: "FLOW";
+    METRIC: "METRIC";
+    TIMELINE: "TIMELINE";
+}>, z.ZodString]> & {
+    enum: {
+        COMPARISON: "COMPARISON";
+        FLOW: "FLOW";
+        METRIC: "METRIC";
+        TIMELINE: "TIMELINE";
+    };
+};
+export type EntityAnalysisFigureType = z.infer<typeof EntityAnalysisFigureTypeSchema>;
+//# sourceMappingURL=analysis-figure-type.d.ts.map

package/dist/entity/analysis-figure-type.js

@@ -0,0 +1,20 @@
+// 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 EntityAnalysisFigureTypeSchemaKnownMembers = z.enum([
+    "COMPARISON",
+    "TIMELINE",
+    "FLOW",
+    "METRIC",
+]);
+/**
+ * Figure layout: COMPARISON matrix of parties by attribute, dated TIMELINE, ordered FLOW of steps, or METRIC key figures.
+ *
+ * @openapiSchema EntityAnalysisFigureType
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisFigureSchema
+ * @contractShape entity.analysis-figure-type
+ * @contractRole canonical
+ */
+export const EntityAnalysisFigureTypeSchema = Object.assign(z.union([EntityAnalysisFigureTypeSchemaKnownMembers, z.string()]), { enum: EntityAnalysisFigureTypeSchemaKnownMembers.enum });
+//# sourceMappingURL=analysis-figure-type.js.map

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

@@ -0,0 +1,48 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisFigureSchemaDefinition: z.ZodObject<{
+    column: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    entry: z.ZodArray<z.ZodType<{
+        cell: {
+            citation: number;
+            excerpt: string;
+        }[];
+        label: string;
+    }, import("./analysis-figure-entry.ts").EntityAnalysisFigureEntrySchemaInput, z.core.$ZodTypeInternals<{
+        cell: {
+            citation: number;
+            excerpt: string;
+        }[];
+        label: string;
+    }, import("./analysis-figure-entry.ts").EntityAnalysisFigureEntrySchemaInput>>>;
+    title: z.ZodString;
+    type: z.ZodUnion<readonly [z.ZodEnum<{
+        COMPARISON: "COMPARISON";
+        FLOW: "FLOW";
+        METRIC: "METRIC";
+        TIMELINE: "TIMELINE";
+    }>, z.ZodString]> & {
+        enum: {
+            COMPARISON: "COMPARISON";
+            FLOW: "FLOW";
+            METRIC: "METRIC";
+            TIMELINE: "TIMELINE";
+        };
+    };
+}, z.core.$strip>;
+type EntityAnalysisFigureDefinition = z.infer<typeof EntityAnalysisFigureSchemaDefinition>;
+export interface EntityAnalysisFigureSchemaInput extends z.input<typeof EntityAnalysisFigureSchemaDefinition> {
+}
+/**
+ * One figure illustrating its section; every cell is a verbatim excerpt of a section quote.
+ *
+ * @openapiSchema EntityAnalysisFigure
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-figure
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisFigureSchema: z.ZodType<EntityAnalysisFigureDefinition, EntityAnalysisFigureSchemaInput>;
+export type EntityAnalysisFigure = z.infer<typeof EntityAnalysisFigureSchema>;
+export {};
+//# sourceMappingURL=analysis-figure.d.ts.map

package/dist/entity/analysis-figure.js

@@ -0,0 +1,26 @@
+// 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 { EntityAnalysisFigureEntrySchema } from "./analysis-figure-entry.js";
+import { EntityAnalysisFigureTypeSchema } from "./analysis-figure-type.js";
+const EntityAnalysisFigureSchemaDefinition = z.object({
+    /** COMPARISON column headings (1-4, each 1-48 characters), one per cell in every entry; empty otherwise. */
+    column: z.array(z.string()).optional(),
+    /** Entries in display order: 2-8, or 1-8 for METRIC. */
+    entry: z.array(EntityAnalysisFigureEntrySchema),
+    /** Caption stating what the figure shows. */
+    title: z.string().min(1).max(100),
+    /** Layout that decides how entries and columns render. */
+    type: EntityAnalysisFigureTypeSchema,
+});
+/**
+ * One figure illustrating its section; every cell is a verbatim excerpt of a section quote.
+ *
+ * @openapiSchema EntityAnalysisFigure
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-figure
+ * @contractRole canonical
+ */
+export const EntityAnalysisFigureSchema = EntityAnalysisFigureSchemaDefinition;
+//# sourceMappingURL=analysis-figure.js.map

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

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+/**
+ * One analysis tool invocation
+ *
+ * @openapiSchema EntityAnalysisInvocation
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @usedBySchema HarnessRunTurnSchema
+ * @contractShape entity.analysis-invocation
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisInvocationSchema: z.ZodObject<{
+    instruction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sectionKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tool: z.ZodEnum<{
+        LIST_SECTION: "LIST_SECTION";
+        RENDER_SECTION: "RENDER_SECTION";
+    }>;
+}, z.core.$strip>;
+export type EntityAnalysisInvocation = z.infer<typeof EntityAnalysisInvocationSchema>;
+//# sourceMappingURL=analysis-invocation.d.ts.map

package/dist/entity/analysis-invocation.js

@@ -0,0 +1,21 @@
+// 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 { EntityAnalysisToolSchema } from "./analysis-tool.js";
+/**
+ * One analysis tool invocation
+ *
+ * @openapiSchema EntityAnalysisInvocation
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @usedBySchema HarnessRunTurnSchema
+ * @contractShape entity.analysis-invocation
+ * @contractRole canonical
+ */
+export const EntityAnalysisInvocationSchema = z.object({
+    /** Instruction for the tool within the conversation turn character limit */
+    instruction: z.string().nullish(),
+    /** Exact snippet catalog typeValue; required for RENDER_SECTION */
+    sectionKey: z.string().nullish(),
+    /** Analysis tool to invoke */
+    tool: EntityAnalysisToolSchema,
+});
+//# sourceMappingURL=analysis-invocation.js.map

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

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisParagraphSchemaDefinition: z.ZodObject<{
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodString;
+}, z.core.$strip>;
+type EntityAnalysisParagraphDefinition = z.infer<typeof EntityAnalysisParagraphSchemaDefinition>;
+export interface EntityAnalysisParagraphSchemaInput extends z.input<typeof EntityAnalysisParagraphSchemaDefinition> {
+}
+/**
+ * A single paragraph of analysis.
+ *
+ * @openapiSchema EntityAnalysisParagraph
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-paragraph
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisParagraphSchema: z.ZodType<EntityAnalysisParagraphDefinition, EntityAnalysisParagraphSchemaInput>;
+export type EntityAnalysisParagraph = z.infer<typeof EntityAnalysisParagraphSchema>;
+export {};
+//# sourceMappingURL=analysis-paragraph.d.ts.map

package/dist/entity/analysis-paragraph.js

@@ -0,0 +1,20 @@
+// 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 EntityAnalysisParagraphSchemaDefinition = z.object({
+    /** Catalog analysisSectionLabel at this position; null for ordinary prose. */
+    label: z.string().nullish(),
+    /** One nonempty paragraph without embedded line breaks. */
+    text: z.string(),
+});
+/**
+ * A single paragraph of analysis.
+ *
+ * @openapiSchema EntityAnalysisParagraph
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-paragraph
+ * @contractRole canonical
+ */
+export const EntityAnalysisParagraphSchema = EntityAnalysisParagraphSchemaDefinition;
+//# sourceMappingURL=analysis-paragraph.js.map

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

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+/**
+ * Author of a draft section: the run's agent or its signed-in owner.
+ *
+ * @openapiSchema EntityAnalysisSectionOrigin
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-section-origin
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisSectionOriginSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    AGENT: "AGENT";
+    USER: "USER";
+}>, z.ZodString]> & {
+    enum: {
+        AGENT: "AGENT";
+        USER: "USER";
+    };
+};
+export type EntityAnalysisSectionOrigin = z.infer<typeof EntityAnalysisSectionOriginSchema>;
+//# sourceMappingURL=analysis-section-origin.d.ts.map

package/dist/entity/analysis-section-origin.js

@@ -0,0 +1,15 @@
+// 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 EntityAnalysisSectionOriginSchemaKnownMembers = z.enum(["AGENT", "USER"]);
+/**
+ * Author of a draft section: the run's agent or its signed-in owner.
+ *
+ * @openapiSchema EntityAnalysisSectionOrigin
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionSchema
+ * @contractShape entity.analysis-section-origin
+ * @contractRole canonical
+ */
+export const EntityAnalysisSectionOriginSchema = Object.assign(z.union([EntityAnalysisSectionOriginSchemaKnownMembers, z.string()]), { enum: EntityAnalysisSectionOriginSchemaKnownMembers.enum });
+//# sourceMappingURL=analysis-section-origin.js.map

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

@@ -0,0 +1,68 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisSectionSchemaDefinition: z.ZodObject<{
+    citation: z.ZodArray<z.ZodType<{
+        quote: string;
+        sourceDocumentId: string;
+    }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput, z.core.$ZodTypeInternals<{
+        quote: string;
+        sourceDocumentId: string;
+    }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput>>>;
+    figure: z.ZodOptional<z.ZodArray<z.ZodType<{
+        column?: string[] | undefined;
+        entry: {
+            cell: {
+                citation: number;
+                excerpt: string;
+            }[];
+            label: string;
+        }[];
+        title: string;
+        type: string;
+    }, import("./analysis-figure.ts").EntityAnalysisFigureSchemaInput, z.core.$ZodTypeInternals<{
+        column?: string[] | undefined;
+        entry: {
+            cell: {
+                citation: number;
+                excerpt: string;
+            }[];
+            label: string;
+        }[];
+        title: string;
+        type: string;
+    }, import("./analysis-figure.ts").EntityAnalysisFigureSchemaInput>>>>;
+    key: z.ZodString;
+    origin: z.ZodUnion<readonly [z.ZodEnum<{
+        AGENT: "AGENT";
+        USER: "USER";
+    }>, z.ZodString]> & {
+        enum: {
+            AGENT: "AGENT";
+            USER: "USER";
+        };
+    };
+    paragraph: z.ZodArray<z.ZodType<{
+        label?: string | null | undefined;
+        text: string;
+    }, import("./analysis-paragraph.ts").EntityAnalysisParagraphSchemaInput, z.core.$ZodTypeInternals<{
+        label?: string | null | undefined;
+        text: string;
+    }, import("./analysis-paragraph.ts").EntityAnalysisParagraphSchemaInput>>>;
+    title: z.ZodString;
+}, z.core.$strip>;
+type EntityAnalysisSectionDefinition = z.infer<typeof EntityAnalysisSectionSchemaDefinition>;
+export interface EntityAnalysisSectionSchemaInput extends z.input<typeof EntityAnalysisSectionSchemaDefinition> {
+}
+/**
+ * One unverified analysis section; replace it by its snippet type key.
+ *
+ * @openapiSchema EntityAnalysisSection
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisDraftSchema
+ * @contractShape entity.analysis-section
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisSectionSchema: z.ZodType<EntityAnalysisSectionDefinition, EntityAnalysisSectionSchemaInput>;
+export type EntityAnalysisSection = z.infer<typeof EntityAnalysisSectionSchema>;
+export {};
+//# sourceMappingURL=analysis-section.d.ts.map