@aventurevc/api-schemas 0.8.324 → 0.8.325

package/dist/entity/writer-brief.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod/v4";
+/**
+ * Finished entity-text research analysis and section-free paragraph plan.
+ *
+ * @openapiSchema EntityWriterBrief
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessTaskInputBindingSchema
+ * @contractShape entity.writer-brief
+ * @contractRole canonical
+ */
+export declare const EntityWriterBriefSchema: 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 | undefined;
+        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 | undefined;
+        writerSurface?: string | null | undefined;
+    }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;
+    metaAnalysis: z.ZodType<{
+        answer: {
+            claim: number[];
+            statement: string;
+        };
+        asOfDate: string;
+        changeSignal: {
+            claim: number[];
+            statement: string;
+        }[];
+        gap: {
+            claim: number[];
+            reason: string;
+            statement: string;
+        }[];
+        question: string;
+        scope: {
+            boundary: string;
+            geography?: string | null | undefined;
+            period?: string | null | undefined;
+        };
+    }, import("./writer-meta-analysis.ts").EntityWriterMetaAnalysisSchemaInput, z.core.$ZodTypeInternals<{
+        answer: {
+            claim: number[];
+            statement: string;
+        };
+        asOfDate: string;
+        changeSignal: {
+            claim: number[];
+            statement: string;
+        }[];
+        gap: {
+            claim: number[];
+            reason: string;
+            statement: string;
+        }[];
+        question: string;
+        scope: {
+            boundary: string;
+            geography?: string | null | undefined;
+            period?: string | null | undefined;
+        };
+    }, import("./writer-meta-analysis.ts").EntityWriterMetaAnalysisSchemaInput>>;
+    outputClaim: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+    paragraph: z.ZodArray<z.ZodType<{
+        analysis: {
+            answer: boolean;
+        };
+        claim: number[];
+        positioning: string[];
+    }, import("./writer-paragraph.ts").EntityWriterParagraphSchemaInput, z.core.$ZodTypeInternals<{
+        analysis: {
+            answer: boolean;
+        };
+        claim: number[];
+        positioning: string[];
+    }, import("./writer-paragraph.ts").EntityWriterParagraphSchemaInput>>>;
+    positioning: z.ZodArray<z.ZodType<{
+        claim: number[];
+        element: string;
+        statement: string;
+    }, import("../writer/positioning.ts").WriterPositioningSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        element: string;
+        statement: string;
+    }, import("../writer/positioning.ts").WriterPositioningSchemaInput>>>;
+}, z.core.$strip>;
+export type EntityWriterBrief = z.infer<typeof EntityWriterBriefSchema>;
+//# sourceMappingURL=writer-brief.d.ts.map

package/dist/entity/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 { EntityWriterMetaAnalysisSchema } from "./writer-meta-analysis.js";
+import { EntityWriterParagraphSchema } from "./writer-paragraph.js";
+import { ResearchFindingSchema } from "../research/finding.js";
+import { WriterPositioningSchema } from "../writer/positioning.js";
+/**
+ * Finished entity-text research analysis and section-free paragraph plan.
+ *
+ * @openapiSchema EntityWriterBrief
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessTaskInputBindingSchema
+ * @contractShape entity.writer-brief
+ * @contractRole canonical
+ */
+export const EntityWriterBriefSchema = z.object({
+    /** Complete evidence ledger with source page and verbatim quote. */
+    claim: z.array(ResearchFindingSchema),
+    /** Finished research question, answer, gaps, and change signals. */
+    metaAnalysis: EntityWriterMetaAnalysisSchema,
+    /** 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(EntityWriterParagraphSchema),
+    /** Positioning decisions selected by research. Put each decision and all its cited claims in one paragraph. A listed decision stays in that paragraph; an unlisted decision goes to the paragraph of its first cited claim. */
+    positioning: z.array(WriterPositioningSchema),
+});
+//# sourceMappingURL=writer-brief.js.map

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

@@ -0,0 +1,54 @@
+import { z } from "zod/v4";
+declare const EntityWriterMetaAnalysisSchemaDefinition: z.ZodObject<{
+    answer: z.ZodType<{
+        claim: number[];
+        statement: string;
+    }, import("../writer/judgment.ts").WriterJudgmentSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        statement: string;
+    }, import("../writer/judgment.ts").WriterJudgmentSchemaInput>>;
+    asOfDate: z.ZodISODate;
+    changeSignal: z.ZodArray<z.ZodType<{
+        claim: number[];
+        statement: string;
+    }, import("../writer/change-signal.ts").WriterChangeSignalSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        statement: string;
+    }, import("../writer/change-signal.ts").WriterChangeSignalSchemaInput>>>;
+    gap: z.ZodArray<z.ZodType<{
+        claim: number[];
+        reason: string;
+        statement: string;
+    }, import("../writer/gap.ts").WriterGapSchemaInput, z.core.$ZodTypeInternals<{
+        claim: number[];
+        reason: string;
+        statement: string;
+    }, import("../writer/gap.ts").WriterGapSchemaInput>>>;
+    question: z.ZodString;
+    scope: z.ZodType<{
+        boundary: string;
+        geography?: string | null | undefined;
+        period?: string | null | undefined;
+    }, import("../writer/scope.ts").WriterScopeSchemaInput, z.core.$ZodTypeInternals<{
+        boundary: string;
+        geography?: string | null | undefined;
+        period?: string | null | undefined;
+    }, import("../writer/scope.ts").WriterScopeSchemaInput>>;
+}, z.core.$strip>;
+type EntityWriterMetaAnalysisDefinition = z.infer<typeof EntityWriterMetaAnalysisSchemaDefinition>;
+export interface EntityWriterMetaAnalysisSchemaInput extends z.input<typeof EntityWriterMetaAnalysisSchemaDefinition> {
+}
+/**
+ * Entity-text research judgment without framework sections.
+ *
+ * @openapiSchema EntityWriterMetaAnalysis
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema EntityWriterBriefSchema
+ * @contractShape entity.writer-meta-analysis
+ * @contractRole canonical
+ */
+export declare const EntityWriterMetaAnalysisSchema: z.ZodType<EntityWriterMetaAnalysisDefinition, EntityWriterMetaAnalysisSchemaInput>;
+export type EntityWriterMetaAnalysis = z.infer<typeof EntityWriterMetaAnalysisSchema>;
+export {};
+//# sourceMappingURL=writer-meta-analysis.d.ts.map

package/dist/entity/writer-meta-analysis.js

@@ -0,0 +1,32 @@
+// 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 { WriterChangeSignalSchema } from "../writer/change-signal.js";
+import { WriterGapSchema } from "../writer/gap.js";
+import { WriterJudgmentSchema } from "../writer/judgment.js";
+import { WriterScopeSchema } from "../writer/scope.js";
+const EntityWriterMetaAnalysisSchemaDefinition = 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,
+});
+/**
+ * Entity-text research judgment without framework sections.
+ *
+ * @openapiSchema EntityWriterMetaAnalysis
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema EntityWriterBriefSchema
+ * @contractShape entity.writer-meta-analysis
+ * @contractRole canonical
+ */
+export const EntityWriterMetaAnalysisSchema = EntityWriterMetaAnalysisSchemaDefinition;
+//# sourceMappingURL=writer-meta-analysis.js.map

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

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const EntityWriterParagraphAnalysisSchemaDefinition: z.ZodObject<{
+    answer: z.ZodBoolean;
+}, z.core.$strip>;
+type EntityWriterParagraphAnalysisDefinition = z.infer<typeof EntityWriterParagraphAnalysisSchemaDefinition>;
+export interface EntityWriterParagraphAnalysisSchemaInput extends z.input<typeof EntityWriterParagraphAnalysisSchemaDefinition> {
+}
+/**
+ * Overall research answer assignment for entity text.
+ *
+ * @openapiSchema EntityWriterParagraphAnalysis
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema EntityWriterParagraphSchema
+ * @contractShape entity.writer-paragraph-analysis
+ * @contractRole canonical
+ */
+export declare const EntityWriterParagraphAnalysisSchema: z.ZodType<EntityWriterParagraphAnalysisDefinition, EntityWriterParagraphAnalysisSchemaInput>;
+export type EntityWriterParagraphAnalysis = z.infer<typeof EntityWriterParagraphAnalysisSchema>;
+export {};
+//# sourceMappingURL=writer-paragraph-analysis.d.ts.map

package/dist/entity/writer-paragraph-analysis.js

@@ -0,0 +1,18 @@
+// 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 EntityWriterParagraphAnalysisSchemaDefinition = z.object({
+    /** Whether this paragraph states the overall research answer; true on the first paragraph only. */
+    answer: z.boolean(),
+});
+/**
+ * Overall research answer assignment for entity text.
+ *
+ * @openapiSchema EntityWriterParagraphAnalysis
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema EntityWriterParagraphSchema
+ * @contractShape entity.writer-paragraph-analysis
+ * @contractRole canonical
+ */
+export const EntityWriterParagraphAnalysisSchema = EntityWriterParagraphAnalysisSchemaDefinition;
+//# sourceMappingURL=writer-paragraph-analysis.js.map

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

@@ -0,0 +1,41 @@
+import { z } from "zod/v4";
+declare const EntityWriterParagraphSchemaDefinition: z.ZodObject<{
+    analysis: z.ZodType<{
+        answer: boolean;
+    }, import("./writer-paragraph-analysis.ts").EntityWriterParagraphAnalysisSchemaInput, z.core.$ZodTypeInternals<{
+        answer: boolean;
+    }, import("./writer-paragraph-analysis.ts").EntityWriterParagraphAnalysisSchemaInput>>;
+    claim: z.ZodArray<z.ZodInt>;
+    positioning: 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 EntityWriterParagraphDefinition = z.infer<typeof EntityWriterParagraphSchemaDefinition>;
+export interface EntityWriterParagraphSchemaInput extends z.input<typeof EntityWriterParagraphSchemaDefinition> {
+}
+/**
+ * One planned entity-text paragraph without framework sections.
+ *
+ * @openapiSchema EntityWriterParagraph
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema EntityWriterBriefSchema
+ * @contractShape entity.writer-paragraph
+ * @contractRole canonical
+ */
+export declare const EntityWriterParagraphSchema: z.ZodType<EntityWriterParagraphDefinition, EntityWriterParagraphSchemaInput>;
+export type EntityWriterParagraph = z.infer<typeof EntityWriterParagraphSchema>;
+export {};
+//# sourceMappingURL=writer-paragraph.d.ts.map

package/dist/entity/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 { EntityWriterParagraphAnalysisSchema } from "./writer-paragraph-analysis.js";
+import { WriterPositioningElementSchema } from "../writer/positioning-element.js";
+const EntityWriterParagraphSchemaDefinition = z.object({
+    /** Overall research answer assigned to this paragraph. */
+    analysis: EntityWriterParagraphAnalysisSchema,
+    /** Output claims this paragraph states, in order. */
+    claim: z.array(z.int()),
+    /** Positioning decisions this paragraph must consume. */
+    positioning: z.array(WriterPositioningElementSchema),
+});
+/**
+ * One planned entity-text paragraph without framework sections.
+ *
+ * @openapiSchema EntityWriterParagraph
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema EntityWriterBriefSchema
+ * @contractShape entity.writer-paragraph
+ * @contractRole canonical
+ */
+export const EntityWriterParagraphSchema = EntityWriterParagraphSchemaDefinition;
+//# sourceMappingURL=writer-paragraph.js.map

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

@@ -27,6 +27,53 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     taskInput: z.ZodOptional<z.ZodArray<z.ZodType<{
         entityId?: string | null | undefined;
+        entityWriterBrief?: {
+            claim: {
+                end?: number | null | undefined;
+                gateId?: string | null | undefined;
+                quote?: string | undefined;
+                sourceDocumentId?: string | null | undefined;
+                sourceUrl: string;
+                start?: number | null | undefined;
+                statement?: string | undefined;
+                writerSurface?: string | null | undefined;
+            }[];
+            metaAnalysis: {
+                answer: {
+                    claim: number[];
+                    statement: string;
+                };
+                asOfDate: string;
+                changeSignal: {
+                    claim: number[];
+                    statement: string;
+                }[];
+                gap: {
+                    claim: number[];
+                    reason: string;
+                    statement: string;
+                }[];
+                question: string;
+                scope: {
+                    boundary: string;
+                    geography?: string | null | undefined;
+                    period?: string | null | undefined;
+                };
+            };
+            outputClaim?: number[] | undefined;
+            paragraph: {
+                analysis: {
+                    answer: boolean;
+                };
+                claim: number[];
+                positioning: string[];
+            }[];
+            positioning: {
+                claim: number[];
+                element: string;
+                statement: string;
+            }[];
+        } | null | undefined;
         fact?: {
             eventDate?: string | null | undefined;
             sourceUrl: string;
@@ -92,6 +139,53 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         } | null | undefined;
     }, import("./task-input-binding.ts").HarnessTaskInputBindingSchemaInput, z.core.$ZodTypeInternals<{
         entityId?: string | null | undefined;
+        entityWriterBrief?: {
+            claim: {
+                end?: number | null | undefined;
+                gateId?: string | null | undefined;
+                quote?: string | undefined;
+                sourceDocumentId?: string | null | undefined;
+                sourceUrl: string;
+                start?: number | null | undefined;
+                statement?: string | undefined;
+                writerSurface?: string | null | undefined;
+            }[];
+            metaAnalysis: {
+                answer: {
+                    claim: number[];
+                    statement: string;
+                };
+                asOfDate: string;
+                changeSignal: {
+                    claim: number[];
+                    statement: string;
+                }[];
+                gap: {
+                    claim: number[];
+                    reason: string;
+                    statement: string;
+                }[];
+                question: string;
+                scope: {
+                    boundary: string;
+                    geography?: string | null | undefined;
+                    period?: string | null | undefined;
+                };
+            };
+            outputClaim?: number[] | undefined;
+            paragraph: {
+                analysis: {
+                    answer: boolean;
+                };
+                claim: number[];
+                positioning: string[];
+            }[];
+            positioning: {
+                claim: number[];
+                element: string;
+                statement: string;
+            }[];
+        } | null | undefined;
         fact?: {
             eventDate?: string | null | undefined;
             sourceUrl: string;

package/dist/harness/task-input-binding.d.ts

@@ -1,6 +1,93 @@
 import { z } from "zod/v4";
 declare const HarnessTaskInputBindingSchemaDefinition: z.ZodObject<{
     entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    entityWriterBrief: z.ZodOptional<z.ZodNullable<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 | undefined;
+            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 | undefined;
+            writerSurface?: string | null | undefined;
+        }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;
+        metaAnalysis: z.ZodType<{
+            answer: {
+                claim: number[];
+                statement: string;
+            };
+            asOfDate: string;
+            changeSignal: {
+                claim: number[];
+                statement: string;
+            }[];
+            gap: {
+                claim: number[];
+                reason: string;
+                statement: string;
+            }[];
+            question: string;
+            scope: {
+                boundary: string;
+                geography?: string | null | undefined;
+                period?: string | null | undefined;
+            };
+        }, import("../entity/writer-meta-analysis.ts").EntityWriterMetaAnalysisSchemaInput, z.core.$ZodTypeInternals<{
+            answer: {
+                claim: number[];
+                statement: string;
+            };
+            asOfDate: string;
+            changeSignal: {
+                claim: number[];
+                statement: string;
+            }[];
+            gap: {
+                claim: number[];
+                reason: string;
+                statement: string;
+            }[];
+            question: string;
+            scope: {
+                boundary: string;
+                geography?: string | null | undefined;
+                period?: string | null | undefined;
+            };
+        }, import("../entity/writer-meta-analysis.ts").EntityWriterMetaAnalysisSchemaInput>>;
+        outputClaim: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+        paragraph: z.ZodArray<z.ZodType<{
+            analysis: {
+                answer: boolean;
+            };
+            claim: number[];
+            positioning: string[];
+        }, import("../entity/writer-paragraph.ts").EntityWriterParagraphSchemaInput, z.core.$ZodTypeInternals<{
+            analysis: {
+                answer: boolean;
+            };
+            claim: number[];
+            positioning: string[];
+        }, import("../entity/writer-paragraph.ts").EntityWriterParagraphSchemaInput>>>;
+        positioning: z.ZodArray<z.ZodType<{
+            claim: number[];
+            element: string;
+            statement: string;
+        }, import("../writer/positioning.ts").WriterPositioningSchemaInput, z.core.$ZodTypeInternals<{
+            claim: number[];
+            element: string;
+            statement: string;
+        }, import("../writer/positioning.ts").WriterPositioningSchemaInput>>>;
+    }, z.core.$strip>>>;
     fact: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         eventDate: z.ZodOptional<z.ZodNullable<z.ZodISODate>>;
         sourceUrl: z.ZodString;

package/dist/harness/task-input-binding.js

@@ -1,10 +1,13 @@
 // 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 { EntityWriterBriefSchema } from "../entity/writer-brief.js";
 import { HarnessTaskFactSchema } from "./task-fact.js";
 import { WriterBriefSchema } from "../writer/brief.js";
 const HarnessTaskInputBindingSchemaDefinition = z.object({
     /** Canonical entity UUID; exclusive with newsId, text, writerBrief and fact. */
     entityId: z.uuid().nullish(),
+    /** Section-free entity or person text brief for a WRITER_BRIEF input; exclusive with writerBrief, entityId, newsId, text and fact. The task must create entity or person text. Use this typed value only with compatible Harness readers; legacy writerBrief remains supported. */
+    entityWriterBrief: EntityWriterBriefSchema.nullish(),
     /** One source-bound fact for a FACT input; exclusive with entityId, newsId, text and writerBrief. */
     fact: HarnessTaskFactSchema.nullish(),
     /** Catalog input key; omit it to bind the task's only declared input of the value's type. */

package/dist/openapi-component-manifest.js

@@ -634,6 +634,19 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "entity/valuation-time-series-point",
         schemaName: "EntityValuationTimeSeriesPointSchema",
     },
+    EntityWriterBrief: { modulePath: "entity/writer-brief", schemaName: "EntityWriterBriefSchema" },
+    EntityWriterMetaAnalysis: {
+        modulePath: "entity/writer-meta-analysis",
+        schemaName: "EntityWriterMetaAnalysisSchema",
+    },
+    EntityWriterParagraph: {
+        modulePath: "entity/writer-paragraph",
+        schemaName: "EntityWriterParagraphSchema",
+    },
+    EntityWriterParagraphAnalysis: {
+        modulePath: "entity/writer-paragraph-analysis",
+        schemaName: "EntityWriterParagraphAnalysisSchema",
+    },
     FederatedNaturalSearch: {
         modulePath: "federated/natural-search",
         schemaName: "FederatedNaturalSearchSchema",

package/dist/research/finding.d.ts

@@ -32,6 +32,7 @@ export interface ResearchFindingSchemaInput extends z.input<typeof ResearchFindi
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
  * @usedBySchema EnrichmentPromptSchema
+ * @usedBySchema EntityWriterBriefSchema
  * @usedBySchema HarnessRunCreateSchema
  * @usedBySchema WriterBriefSchema
  * @contractShape research.finding

package/dist/research/finding.js

@@ -29,6 +29,7 @@ const ResearchFindingSchemaDefinition = z.object({
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
  * @usedBySchema EnrichmentPromptSchema
+ * @usedBySchema EntityWriterBriefSchema
  * @usedBySchema HarnessRunCreateSchema
  * @usedBySchema WriterBriefSchema
  * @contractShape research.finding

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

@@ -14,6 +14,7 @@ export interface WriterChangeSignalSchemaInput extends z.input<typeof WriterChan
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.change-signal
  * @contractRole canonical

package/dist/writer/change-signal.js

@@ -14,6 +14,7 @@ const WriterChangeSignalSchemaDefinition = z.object({
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.change-signal
  * @contractRole canonical

package/dist/writer/gap.d.ts

@@ -27,6 +27,7 @@ export interface WriterGapSchemaInput extends z.input<typeof WriterGapSchemaDefi
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.gap
  * @contractRole canonical

package/dist/writer/gap.js

@@ -17,6 +17,7 @@ const WriterGapSchemaDefinition = z.object({
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.gap
  * @contractRole canonical

package/dist/writer/judgment.d.ts

@@ -14,6 +14,7 @@ export interface WriterJudgmentSchemaInput extends z.input<typeof WriterJudgment
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterAnalysisSectionSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.judgment

package/dist/writer/judgment.js

@@ -14,6 +14,7 @@ const WriterJudgmentSchemaDefinition = z.object({
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterAnalysisSectionSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.judgment

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

@@ -7,6 +7,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterParagraphSchema
  * @usedBySchema WriterParagraphSchema
  * @usedBySchema WriterPositioningSchema
  * @contractShape writer.positioning-element

package/dist/writer/positioning-element.js

@@ -15,6 +15,7 @@ const WriterPositioningElementSchemaKnownMembers = z.enum([
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterParagraphSchema
  * @usedBySchema WriterParagraphSchema
  * @usedBySchema WriterPositioningSchema
  * @contractShape writer.positioning-element

package/dist/writer/positioning.d.ts

@@ -29,6 +29,7 @@ export interface WriterPositioningSchemaInput extends z.input<typeof WriterPosit
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterBriefSchema
  * @usedBySchema WriterBriefSchema
  * @contractShape writer.positioning
  * @contractRole canonical

package/dist/writer/positioning.js

@@ -17,6 +17,7 @@ const WriterPositioningSchemaDefinition = z.object({
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterBriefSchema
  * @usedBySchema WriterBriefSchema
  * @contractShape writer.positioning
  * @contractRole canonical

package/dist/writer/scope.d.ts

@@ -15,6 +15,7 @@ export interface WriterScopeSchemaInput extends z.input<typeof WriterScopeSchema
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.scope
  * @contractRole canonical

package/dist/writer/scope.js

@@ -16,6 +16,7 @@ const WriterScopeSchemaDefinition = z.object({
  * @endpoint POST /v1/research/runs
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityWriterMetaAnalysisSchema
  * @usedBySchema WriterMetaAnalysisSchema
  * @contractShape writer.scope
  * @contractRole canonical

package/package.json

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