@aventurevc/api-schemas 0.8.261 → 0.8.262

package/dist/writer/brief.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod/v4";
+/**
+ * Finished research analysis for a governed prose write. The writer may phrase only the selected output claims and supplied judgments.
+ *
+ * @openapiSchema WriterBrief
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionMutationSchema
+ * @contractShape writer.brief
+ * @contractRole canonical
+ */
+export declare const WriterBriefSchema: z.ZodObject<{
+    claim: z.ZodArray<z.ZodType<{
+        gateId?: string | null | undefined;
+        quote: string;
+        sourceUrl: string;
+        statement: string;
+        writerSurface?: string | null | undefined;
+    }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
+        gateId?: string | null | undefined;
+        quote: string;
+        sourceUrl: string;
+        statement: string;
+        writerSurface?: string | null | undefined;
+    }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;
+    metaAnalysis: z.ZodOptional<z.ZodObject<{
+        answer: z.ZodType<{
+            claim: number[];
+            statement: string;
+        }, import("./judgment.ts").WriterJudgmentSchemaInput, z.core.$ZodTypeInternals<{
+            claim: number[];
+            statement: string;
+        }, import("./judgment.ts").WriterJudgmentSchemaInput>>;
+        asOfDate: z.ZodISODate;
+        changeSignal: z.ZodArray<z.ZodType<{
+            claim: number[];
+            statement: string;
+        }, import("./change-signal.ts").WriterChangeSignalSchemaInput, z.core.$ZodTypeInternals<{
+            claim: number[];
+            statement: string;
+        }, import("./change-signal.ts").WriterChangeSignalSchemaInput>>>;
+        gap: z.ZodArray<z.ZodType<{
+            claim: number[];
+            reason: string;
+            statement: string;
+        }, import("./gap.ts").WriterGapSchemaInput, z.core.$ZodTypeInternals<{
+            claim: number[];
+            reason: string;
+            statement: string;
+        }, import("./gap.ts").WriterGapSchemaInput>>>;
+        question: z.ZodString;
+        scope: z.ZodType<{
+            boundary: string;
+            geography?: string | null | undefined;
+            period?: string | null | undefined;
+        }, import("./scope.ts").WriterScopeSchemaInput, z.core.$ZodTypeInternals<{
+            boundary: string;
+            geography?: string | null | undefined;
+            period?: string | null | undefined;
+        }, import("./scope.ts").WriterScopeSchemaInput>>;
+        section: z.ZodArray<z.ZodType<{
+            judgment: {
+                claim: number[];
+                statement: string;
+            };
+            label: string;
+        }, import("./analysis-section.ts").WriterAnalysisSectionSchemaInput, z.core.$ZodTypeInternals<{
+            judgment: {
+                claim: number[];
+                statement: string;
+            };
+            label: string;
+        }, import("./analysis-section.ts").WriterAnalysisSectionSchemaInput>>>;
+    }, z.core.$strip>>;
+    outputClaim: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+    paragraph: z.ZodArray<z.ZodType<{
+        analysis?: {
+            answer: boolean;
+            section: string[];
+        } | undefined;
+        claim: number[];
+        positioning?: string[] | undefined;
+    }, import("./paragraph.ts").WriterParagraphSchemaInput, z.core.$ZodTypeInternals<{
+        analysis?: {
+            answer: boolean;
+            section: string[];
+        } | undefined;
+        claim: number[];
+        positioning?: string[] | undefined;
+    }, import("./paragraph.ts").WriterParagraphSchemaInput>>>;
+    positioning: z.ZodArray<z.ZodType<{
+        claim: number[];
+        element: string;
+        statement: string;
+    }, import("./positioning.ts").WriterPositioningSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        element: string;
+        statement: string;
+    }, import("./positioning.ts").WriterPositioningSchemaInput>>>;
+}, z.core.$strip>;
+export type WriterBrief = z.infer<typeof WriterBriefSchema>;
+//# sourceMappingURL=brief.d.ts.map

package/dist/writer/brief.js

@@ -0,0 +1,29 @@
+// 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 { ResearchFindingSchema } from "../research/finding.js";
+import { WriterMetaAnalysisSchema } from "./meta-analysis.js";
+import { WriterParagraphSchema } from "./paragraph.js";
+import { WriterPositioningSchema } from "./positioning.js";
+/**
+ * Finished research analysis for a governed prose write. The writer may phrase only the selected output claims and supplied judgments.
+ *
+ * @openapiSchema WriterBrief
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisSectionMutationSchema
+ * @contractShape writer.brief
+ * @contractRole canonical
+ */
+export const WriterBriefSchema = z.object({
+    /** Complete evidence ledger with source page and verbatim quote. */
+    claim: z.array(ResearchFindingSchema),
+    /** Finished research question, answer, framework judgments, gaps, and change signals. */
+    metaAnalysis: WriterMetaAnalysisSchema.optional(),
+    /** Evidence claims this output states: paragraph.claim in paragraph order. Derived by the server; a sent value is ignored. */
+    outputClaim: z.array(z.int()).optional(),
+    /** Paragraph plan; each paragraph states the listed claims and judgments, and paragraph order is the output order; only the first paragraph consumes the answer. */
+    paragraph: z.array(WriterParagraphSchema),
+    /** Positioning decisions selected by research. Each is stated in the paragraph that lists it, else in the paragraph that states its cited claims. */
+    positioning: z.array(WriterPositioningSchema),
+});
+//# sourceMappingURL=brief.js.map

package/dist/writer/change-signal.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const WriterChangeSignalSchemaDefinition: z.ZodObject<{
+    claim: z.ZodArray<z.ZodInt>;
+    statement: z.ZodString;
+}, z.core.$strip>;
+type WriterChangeSignalDefinition = z.infer<typeof WriterChangeSignalSchemaDefinition>;
+export interface WriterChangeSignalSchemaInput extends z.input<typeof WriterChangeSignalSchemaDefinition> {
+}
+/**
+ * Evidence that would change the supplied judgment.
+ *
+ * @openapiSchema WriterChangeSignal
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.change-signal
+ * @contractRole canonical
+ */
+export declare const WriterChangeSignalSchema: z.ZodType<WriterChangeSignalDefinition, WriterChangeSignalSchemaInput>;
+export type WriterChangeSignal = z.infer<typeof WriterChangeSignalSchema>;
+export {};
+//# sourceMappingURL=change-signal.d.ts.map

package/dist/writer/change-signal.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 WriterChangeSignalSchemaDefinition = z.object({
+    /** Evidence claim numbers supporting the signal. */
+    claim: z.array(z.int()),
+    /** Observable signal that would change the view. */
+    statement: z.string(),
+});
+/**
+ * Evidence that would change the supplied judgment.
+ *
+ * @openapiSchema WriterChangeSignal
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.change-signal
+ * @contractRole canonical
+ */
+export const WriterChangeSignalSchema = WriterChangeSignalSchemaDefinition;
+//# sourceMappingURL=change-signal.js.map

package/dist/writer/claim-surface.d.ts

@@ -6,6 +6,8 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/entities/{entityId}/enrichments
  * @endpoint POST /v1/research-runs
  * @endpoint POST /v1/research/runs
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
  * @usedBySchema ResearchFindingSchema
  * @contractShape writer.claim-surface
  * @contractRole canonical

package/dist/writer/claim-surface.js

@@ -8,6 +8,8 @@ const WriterClaimSurfaceSchemaKnownMembers = z.enum(["ENTITY_TEXT", "RESEARCH_SN
  * @endpoint POST /v1/entities/{entityId}/enrichments
  * @endpoint POST /v1/research-runs
  * @endpoint POST /v1/research/runs
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
  * @usedBySchema ResearchFindingSchema
  * @contractShape writer.claim-surface
  * @contractRole canonical

package/dist/writer/gap-reason.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+/**
+ * Reason a research gap remains unresolved.
+ *
+ * @openapiSchema WriterGapReason
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterGapSchema
+ * @contractShape writer.gap-reason
+ * @contractRole canonical
+ */
+export declare const WriterGapReasonSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    CONFLICTING: "CONFLICTING";
+    NOT_APPLICABLE: "NOT_APPLICABLE";
+    NOT_DISCLOSED: "NOT_DISCLOSED";
+    NOT_FOUND: "NOT_FOUND";
+}>, z.ZodString]> & {
+    enum: {
+        CONFLICTING: "CONFLICTING";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+        NOT_DISCLOSED: "NOT_DISCLOSED";
+        NOT_FOUND: "NOT_FOUND";
+    };
+};
+export type WriterGapReason = z.infer<typeof WriterGapReasonSchema>;
+//# sourceMappingURL=gap-reason.d.ts.map

package/dist/writer/gap-reason.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 WriterGapReasonSchemaKnownMembers = z.enum([
+    "NOT_DISCLOSED",
+    "NOT_FOUND",
+    "NOT_APPLICABLE",
+    "CONFLICTING",
+]);
+/**
+ * Reason a research gap remains unresolved.
+ *
+ * @openapiSchema WriterGapReason
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterGapSchema
+ * @contractShape writer.gap-reason
+ * @contractRole canonical
+ */
+export const WriterGapReasonSchema = Object.assign(z.union([WriterGapReasonSchemaKnownMembers, z.string()]), { enum: WriterGapReasonSchemaKnownMembers.enum });
+//# sourceMappingURL=gap-reason.js.map

package/dist/writer/gap.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod/v4";
+declare const WriterGapSchemaDefinition: z.ZodObject<{
+    claim: z.ZodArray<z.ZodInt>;
+    reason: z.ZodUnion<readonly [z.ZodEnum<{
+        CONFLICTING: "CONFLICTING";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+        NOT_DISCLOSED: "NOT_DISCLOSED";
+        NOT_FOUND: "NOT_FOUND";
+    }>, z.ZodString]> & {
+        enum: {
+            CONFLICTING: "CONFLICTING";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+            NOT_DISCLOSED: "NOT_DISCLOSED";
+            NOT_FOUND: "NOT_FOUND";
+        };
+    };
+    statement: z.ZodString;
+}, z.core.$strip>;
+type WriterGapDefinition = z.infer<typeof WriterGapSchemaDefinition>;
+export interface WriterGapSchemaInput extends z.input<typeof WriterGapSchemaDefinition> {
+}
+/**
+ * A known evidence gap or conflict.
+ *
+ * @openapiSchema WriterGap
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.gap
+ * @contractRole canonical
+ */
+export declare const WriterGapSchema: z.ZodType<WriterGapDefinition, WriterGapSchemaInput>;
+export type WriterGap = z.infer<typeof WriterGapSchema>;
+export {};
+//# sourceMappingURL=gap.d.ts.map

package/dist/writer/gap.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 { WriterGapReasonSchema } from "./gap-reason.js";
+const WriterGapSchemaDefinition = z.object({
+    /** Evidence claim numbers supporting the gap. */
+    claim: z.array(z.int()),
+    /** Why the gap is present. */
+    reason: WriterGapReasonSchema,
+    /** What is missing or unresolved. */
+    statement: z.string(),
+});
+/**
+ * A known evidence gap or conflict.
+ *
+ * @openapiSchema WriterGap
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.gap
+ * @contractRole canonical
+ */
+export const WriterGapSchema = WriterGapSchemaDefinition;
+//# sourceMappingURL=gap.js.map

package/dist/writer/judgment.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v4";
+declare const WriterJudgmentSchemaDefinition: z.ZodObject<{
+    claim: z.ZodArray<z.ZodInt>;
+    statement: z.ZodString;
+}, z.core.$strip>;
+type WriterJudgmentDefinition = z.infer<typeof WriterJudgmentSchemaDefinition>;
+export interface WriterJudgmentSchemaInput extends z.input<typeof WriterJudgmentSchemaDefinition> {
+}
+/**
+ * One sourced research judgment.
+ *
+ * @openapiSchema WriterJudgment
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterAnalysisSectionSchema
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.judgment
+ * @contractRole canonical
+ */
+export declare const WriterJudgmentSchema: z.ZodType<WriterJudgmentDefinition, WriterJudgmentSchemaInput>;
+export type WriterJudgment = z.infer<typeof WriterJudgmentSchema>;
+export {};
+//# sourceMappingURL=judgment.d.ts.map

package/dist/writer/judgment.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";
+const WriterJudgmentSchemaDefinition = z.object({
+    /** Evidence claim numbers supporting the judgment. */
+    claim: z.array(z.int()),
+    /** The judgment in plain words. */
+    statement: z.string(),
+});
+/**
+ * One sourced research judgment.
+ *
+ * @openapiSchema WriterJudgment
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterAnalysisSectionSchema
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.judgment
+ * @contractRole canonical
+ */
+export const WriterJudgmentSchema = WriterJudgmentSchemaDefinition;
+//# sourceMappingURL=judgment.js.map

package/dist/writer/meta-analysis.d.ts

@@ -0,0 +1,62 @@
+import { z } from "zod/v4";
+/**
+ * Research judgment the writer must preserve.
+ *
+ * @openapiSchema WriterMetaAnalysis
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterBriefSchema
+ * @contractShape writer.meta-analysis
+ * @contractRole canonical
+ */
+export declare const WriterMetaAnalysisSchema: z.ZodObject<{
+    answer: z.ZodType<{
+        claim: number[];
+        statement: string;
+    }, import("./judgment.ts").WriterJudgmentSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        statement: string;
+    }, import("./judgment.ts").WriterJudgmentSchemaInput>>;
+    asOfDate: z.ZodISODate;
+    changeSignal: z.ZodArray<z.ZodType<{
+        claim: number[];
+        statement: string;
+    }, import("./change-signal.ts").WriterChangeSignalSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        statement: string;
+    }, import("./change-signal.ts").WriterChangeSignalSchemaInput>>>;
+    gap: z.ZodArray<z.ZodType<{
+        claim: number[];
+        reason: string;
+        statement: string;
+    }, import("./gap.ts").WriterGapSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        reason: string;
+        statement: string;
+    }, import("./gap.ts").WriterGapSchemaInput>>>;
+    question: z.ZodString;
+    scope: z.ZodType<{
+        boundary: string;
+        geography?: string | null | undefined;
+        period?: string | null | undefined;
+    }, import("./scope.ts").WriterScopeSchemaInput, z.core.$ZodTypeInternals<{
+        boundary: string;
+        geography?: string | null | undefined;
+        period?: string | null | undefined;
+    }, import("./scope.ts").WriterScopeSchemaInput>>;
+    section: z.ZodArray<z.ZodType<{
+        judgment: {
+            claim: number[];
+            statement: string;
+        };
+        label: string;
+    }, import("./analysis-section.ts").WriterAnalysisSectionSchemaInput, z.core.$ZodTypeInternals<{
+        judgment: {
+            claim: number[];
+            statement: string;
+        };
+        label: string;
+    }, import("./analysis-section.ts").WriterAnalysisSectionSchemaInput>>>;
+}, z.core.$strip>;
+export type WriterMetaAnalysis = z.infer<typeof WriterMetaAnalysisSchema>;
+//# sourceMappingURL=meta-analysis.d.ts.map

package/dist/writer/meta-analysis.js

@@ -0,0 +1,34 @@
+// 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 { WriterAnalysisSectionSchema } from "./analysis-section.js";
+import { WriterChangeSignalSchema } from "./change-signal.js";
+import { WriterGapSchema } from "./gap.js";
+import { WriterJudgmentSchema } from "./judgment.js";
+import { WriterScopeSchema } from "./scope.js";
+/**
+ * Research judgment the writer must preserve.
+ *
+ * @openapiSchema WriterMetaAnalysis
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterBriefSchema
+ * @contractShape writer.meta-analysis
+ * @contractRole canonical
+ */
+export const WriterMetaAnalysisSchema = z.object({
+    /** Overall answer to the research question. */
+    answer: WriterJudgmentSchema,
+    /** Date through which the judgment is current. */
+    asOfDate: z.iso.date(),
+    /** Evidence that would change the supplied view. */
+    changeSignal: z.array(WriterChangeSignalSchema),
+    /** Known gaps or conflicts that must not become invented facts. */
+    gap: z.array(WriterGapSchema),
+    /** Question the research answered. */
+    question: z.string(),
+    /** Boundary and period used by the research. */
+    scope: WriterScopeSchema,
+    /** Ordered framework judgments, when the skill defines sections. */
+    section: z.array(WriterAnalysisSectionSchema),
+});
+//# sourceMappingURL=meta-analysis.js.map

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

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * Meta-analysis judgments assigned to one paragraph.
+ *
+ * @openapiSchema WriterParagraphAnalysis
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterParagraphSchema
+ * @contractShape writer.paragraph-analysis
+ * @contractRole canonical
+ */
+export declare const WriterParagraphAnalysisSchema: z.ZodObject<{
+    answer: z.ZodBoolean;
+    section: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type WriterParagraphAnalysis = z.infer<typeof WriterParagraphAnalysisSchema>;
+//# sourceMappingURL=paragraph-analysis.d.ts.map

package/dist/writer/paragraph-analysis.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";
+/**
+ * Meta-analysis judgments assigned to one paragraph.
+ *
+ * @openapiSchema WriterParagraphAnalysis
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterParagraphSchema
+ * @contractShape writer.paragraph-analysis
+ * @contractRole canonical
+ */
+export const WriterParagraphAnalysisSchema = z.object({
+    /** Whether this paragraph states the overall research answer; true on the first paragraph only. */
+    answer: z.boolean(),
+    /** Framework section labels this paragraph must state, in order. */
+    section: z.array(z.string()),
+});
+//# sourceMappingURL=paragraph-analysis.js.map

package/dist/writer/paragraph.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod/v4";
+declare const WriterParagraphSchemaDefinition: z.ZodObject<{
+    analysis: z.ZodOptional<z.ZodObject<{
+        answer: z.ZodBoolean;
+        section: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    claim: z.ZodArray<z.ZodInt>;
+    positioning: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+        ALTERNATIVE: "ALTERNATIVE";
+        APPROACH: "APPROACH";
+        BUYER: "BUYER";
+        CATEGORY: "CATEGORY";
+        DIFFERENTIATION: "DIFFERENTIATION";
+    }>, z.ZodString]> & {
+        enum: {
+            ALTERNATIVE: "ALTERNATIVE";
+            APPROACH: "APPROACH";
+            BUYER: "BUYER";
+            CATEGORY: "CATEGORY";
+            DIFFERENTIATION: "DIFFERENTIATION";
+        };
+    }>>;
+}, z.core.$strip>;
+type WriterParagraphDefinition = z.infer<typeof WriterParagraphSchemaDefinition>;
+export interface WriterParagraphSchemaInput extends z.input<typeof WriterParagraphSchemaDefinition> {
+}
+/**
+ * One planned paragraph.
+ *
+ * @openapiSchema WriterParagraph
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterBriefSchema
+ * @contractShape writer.paragraph
+ * @contractRole canonical
+ */
+export declare const WriterParagraphSchema: z.ZodType<WriterParagraphDefinition, WriterParagraphSchemaInput>;
+export type WriterParagraph = z.infer<typeof WriterParagraphSchema>;
+export {};
+//# sourceMappingURL=paragraph.d.ts.map

package/dist/writer/paragraph.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 { WriterParagraphAnalysisSchema } from "./paragraph-analysis.js";
+import { WriterPositioningElementSchema } from "./positioning-element.js";
+const WriterParagraphSchemaDefinition = z.object({
+    /** Meta-analysis judgments this paragraph must consume. */
+    analysis: WriterParagraphAnalysisSchema.optional(),
+    /** Output claims this paragraph states, in order. */
+    claim: z.array(z.int()),
+    /** Positioning decisions this paragraph must consume; each declared decision at most once across paragraphs. An unlisted decision goes to the paragraph that states its claims. */
+    positioning: z.array(WriterPositioningElementSchema).optional(),
+});
+/**
+ * One planned paragraph.
+ *
+ * @openapiSchema WriterParagraph
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterBriefSchema
+ * @contractShape writer.paragraph
+ * @contractRole canonical
+ */
+export const WriterParagraphSchema = WriterParagraphSchemaDefinition;
+//# sourceMappingURL=paragraph.js.map

package/dist/writer/positioning-element.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+/**
+ * Research-selected category, buyer, approach, differentiation, or alternative.
+ *
+ * @openapiSchema WriterPositioningElement
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterParagraphSchema
+ * @usedBySchema WriterPositioningSchema
+ * @contractShape writer.positioning-element
+ * @contractRole canonical
+ */
+export declare const WriterPositioningElementSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    ALTERNATIVE: "ALTERNATIVE";
+    APPROACH: "APPROACH";
+    BUYER: "BUYER";
+    CATEGORY: "CATEGORY";
+    DIFFERENTIATION: "DIFFERENTIATION";
+}>, z.ZodString]> & {
+    enum: {
+        ALTERNATIVE: "ALTERNATIVE";
+        APPROACH: "APPROACH";
+        BUYER: "BUYER";
+        CATEGORY: "CATEGORY";
+        DIFFERENTIATION: "DIFFERENTIATION";
+    };
+};
+export type WriterPositioningElement = z.infer<typeof WriterPositioningElementSchema>;
+//# sourceMappingURL=positioning-element.d.ts.map

package/dist/writer/positioning-element.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 WriterPositioningElementSchemaKnownMembers = z.enum([
+    "CATEGORY",
+    "BUYER",
+    "APPROACH",
+    "DIFFERENTIATION",
+    "ALTERNATIVE",
+]);
+/**
+ * Research-selected category, buyer, approach, differentiation, or alternative.
+ *
+ * @openapiSchema WriterPositioningElement
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterParagraphSchema
+ * @usedBySchema WriterPositioningSchema
+ * @contractShape writer.positioning-element
+ * @contractRole canonical
+ */
+export const WriterPositioningElementSchema = Object.assign(z.union([WriterPositioningElementSchemaKnownMembers, z.string()]), { enum: WriterPositioningElementSchemaKnownMembers.enum });
+//# sourceMappingURL=positioning-element.js.map

package/dist/writer/positioning.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod/v4";
+declare const WriterPositioningSchemaDefinition: z.ZodObject<{
+    claim: z.ZodArray<z.ZodInt>;
+    element: z.ZodUnion<readonly [z.ZodEnum<{
+        ALTERNATIVE: "ALTERNATIVE";
+        APPROACH: "APPROACH";
+        BUYER: "BUYER";
+        CATEGORY: "CATEGORY";
+        DIFFERENTIATION: "DIFFERENTIATION";
+    }>, z.ZodString]> & {
+        enum: {
+            ALTERNATIVE: "ALTERNATIVE";
+            APPROACH: "APPROACH";
+            BUYER: "BUYER";
+            CATEGORY: "CATEGORY";
+            DIFFERENTIATION: "DIFFERENTIATION";
+        };
+    };
+    statement: z.ZodString;
+}, z.core.$strip>;
+type WriterPositioningDefinition = z.infer<typeof WriterPositioningSchemaDefinition>;
+export interface WriterPositioningSchemaInput extends z.input<typeof WriterPositioningSchemaDefinition> {
+}
+/**
+ * One positioning decision and supporting claims.
+ *
+ * @openapiSchema WriterPositioning
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterBriefSchema
+ * @contractShape writer.positioning
+ * @contractRole canonical
+ */
+export declare const WriterPositioningSchema: z.ZodType<WriterPositioningDefinition, WriterPositioningSchemaInput>;
+export type WriterPositioning = z.infer<typeof WriterPositioningSchema>;
+export {};
+//# sourceMappingURL=positioning.d.ts.map