@aventurevc/api-schemas 0.8.261 → 0.8.263

package/dist/search/answer-paragraph.js

@@ -1,6 +1,7 @@
 // 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 { SearchAnswerCitationSchema } from "./answer-citation.js";
+import { SearchAnswerWebSourceSchema } from "./answer-web-source.js";
 const SearchAnswerParagraphSchemaDefinition = z.object({
     /** Evidence this paragraph rests on, most important first. */
     citation: z.array(SearchAnswerCitationSchema),
@@ -8,6 +9,8 @@ const SearchAnswerParagraphSchemaDefinition = z.object({
     text: z.string(),
     /** Short label naming the category, market, or segment this paragraph covers, such as "Smartphones · North America"; absent on the lead paragraph. */
     topic: z.string().nullish(),
+    /** Web pages this paragraph rests on that no aVenture record owns, such as an encyclopedia article about a company the directory lacks; most important first. Always sent; absent only from answers written before it existed. */
+    webSource: z.array(SearchAnswerWebSourceSchema).optional(),
 });
 /**
  * One paragraph of an answer and the evidence it rests on.

package/dist/search/answer-web-source.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod/v4";
+declare const SearchAnswerWebSourceSchemaDefinition: z.ZodObject<{
+    title: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+type SearchAnswerWebSourceDefinition = z.infer<typeof SearchAnswerWebSourceSchemaDefinition>;
+export interface SearchAnswerWebSourceSchemaInput extends z.input<typeof SearchAnswerWebSourceSchemaDefinition> {
+}
+/**
+ * A web search result an answer paragraph cites, by its page.
+ *
+ * @openapiSchema SearchAnswerWebSource
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SearchAnswerParagraphSchema
+ * @contractShape search.answer-web-source
+ * @contractRole canonical
+ */
+export declare const SearchAnswerWebSourceSchema: z.ZodType<SearchAnswerWebSourceDefinition, SearchAnswerWebSourceSchemaInput>;
+export type SearchAnswerWebSource = z.infer<typeof SearchAnswerWebSourceSchema>;
+export {};
+//# sourceMappingURL=answer-web-source.d.ts.map

package/dist/search/answer-web-source.js

@@ -0,0 +1,25 @@
+// 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 SearchAnswerWebSourceSchemaDefinition = z.object({
+    /** Title of the cited page as the search result named it. */
+    title: z.string(),
+    /** Address of the cited page. */
+    url: z.string(),
+});
+/**
+ * A web search result an answer paragraph cites, by its page.
+ *
+ * @openapiSchema SearchAnswerWebSource
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SearchAnswerParagraphSchema
+ * @contractShape search.answer-web-source
+ * @contractRole canonical
+ */
+export const SearchAnswerWebSourceSchema = SearchAnswerWebSourceSchemaDefinition;
+//# sourceMappingURL=answer-web-source.js.map

package/dist/search/answer.d.ts

@@ -39,6 +39,10 @@ export declare const SearchAnswerSchema: z.ZodObject<{
         }[];
         text: string;
         topic?: string | null | undefined;
+        webSource?: {
+            title: string;
+            url: string;
+        }[] | undefined;
     }, import("./answer-paragraph.ts").SearchAnswerParagraphSchemaInput, z.core.$ZodTypeInternals<{
         citation: {
             entityId: string;
@@ -47,6 +51,10 @@ export declare const SearchAnswerSchema: z.ZodObject<{
         }[];
         text: string;
         topic?: string | null | undefined;
+        webSource?: {
+            title: string;
+            url: string;
+        }[] | undefined;
     }, import("./answer-paragraph.ts").SearchAnswerParagraphSchemaInput>>>;
     relatedQuery: z.ZodArray<z.ZodString>;
     shareable: z.ZodBoolean;

package/dist/shared/search.d.ts

@@ -31,6 +31,10 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     }[];
                     text: string;
                     topic?: string | null | undefined;
+                    webSource?: {
+                        title: string;
+                        url: string;
+                    }[] | undefined;
                 }[];
                 relatedQuery: string[];
                 shareable: boolean;
@@ -5842,6 +5846,10 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     }[];
                     text: string;
                     topic?: string | null | undefined;
+                    webSource?: {
+                        title: string;
+                        url: string;
+                    }[] | undefined;
                 }[];
                 relatedQuery: string[];
                 shareable: boolean;

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

@@ -0,0 +1,28 @@
+import { z } from "zod/v4";
+declare const WriterAnalysisSectionSchemaDefinition: z.ZodObject<{
+    judgment: z.ZodType<{
+        claim: number[];
+        statement: string;
+    }, import("./judgment.ts").WriterJudgmentSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        statement: string;
+    }, import("./judgment.ts").WriterJudgmentSchemaInput>>;
+    label: z.ZodString;
+}, z.core.$strip>;
+type WriterAnalysisSectionDefinition = z.infer<typeof WriterAnalysisSectionSchemaDefinition>;
+export interface WriterAnalysisSectionSchemaInput extends z.input<typeof WriterAnalysisSectionSchemaDefinition> {
+}
+/**
+ * One ordered framework judgment.
+ *
+ * @openapiSchema WriterAnalysisSection
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.analysis-section
+ * @contractRole canonical
+ */
+export declare const WriterAnalysisSectionSchema: z.ZodType<WriterAnalysisSectionDefinition, WriterAnalysisSectionSchemaInput>;
+export type WriterAnalysisSection = z.infer<typeof WriterAnalysisSectionSchema>;
+export {};
+//# sourceMappingURL=analysis-section.d.ts.map

package/dist/writer/analysis-section.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 { WriterJudgmentSchema } from "./judgment.js";
+const WriterAnalysisSectionSchemaDefinition = z.object({
+    /** Judgment for this section. */
+    judgment: WriterJudgmentSchema,
+    /** Skill-owned section label. */
+    label: z.string(),
+});
+/**
+ * One ordered framework judgment.
+ *
+ * @openapiSchema WriterAnalysisSection
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.analysis-section
+ * @contractRole canonical
+ */
+export const WriterAnalysisSectionSchema = WriterAnalysisSectionSchemaDefinition;
+//# sourceMappingURL=analysis-section.js.map

package/dist/writer/brief.d.ts

@@ -0,0 +1,108 @@
+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<{
+        end?: number | null | undefined;
+        gateId?: string | null | undefined;
+        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 | undefined;
+        sourceDocumentId?: string | null | undefined;
+        sourceUrl: string;
+        start?: number | null | undefined;
+        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