@aventurevc/api-schemas 0.8.291 → 0.8.293

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

@@ -25,6 +25,137 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
     }>>;
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    taskInput: z.ZodOptional<z.ZodArray<z.ZodType<{
+        entityId?: string | null | undefined;
+        fact?: {
+            eventDate?: string | null | undefined;
+            sourceUrl: string;
+            statement: string;
+        } | null | undefined;
+        key?: string | null | undefined;
+        newsId?: number | null | undefined;
+        text?: string | null | undefined;
+        writerBrief?: {
+            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;
+                };
+                section: {
+                    judgment: {
+                        claim: number[];
+                        statement: string;
+                    };
+                    label: string;
+                }[];
+            } | undefined;
+            outputClaim?: number[] | undefined;
+            paragraph: {
+                analysis?: {
+                    answer: boolean;
+                    section: string[];
+                } | undefined;
+                claim: number[];
+                positioning?: string[] | undefined;
+            }[];
+            positioning: {
+                claim: number[];
+                element: string;
+                statement: string;
+            }[];
+        } | null | undefined;
+    }, import("./task-input-binding.ts").HarnessTaskInputBindingSchemaInput, z.core.$ZodTypeInternals<{
+        entityId?: string | null | undefined;
+        fact?: {
+            eventDate?: string | null | undefined;
+            sourceUrl: string;
+            statement: string;
+        } | null | undefined;
+        key?: string | null | undefined;
+        newsId?: number | null | undefined;
+        text?: string | null | undefined;
+        writerBrief?: {
+            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;
+                };
+                section: {
+                    judgment: {
+                        claim: number[];
+                        statement: string;
+                    };
+                    label: string;
+                }[];
+            } | undefined;
+            outputClaim?: number[] | undefined;
+            paragraph: {
+                analysis?: {
+                    answer: boolean;
+                    section: string[];
+                } | undefined;
+                claim: number[];
+                positioning?: string[] | undefined;
+            }[];
+            positioning: {
+                claim: number[];
+                element: string;
+                statement: string;
+            }[];
+        } | null | undefined;
+    }, import("./task-input-binding.ts").HarnessTaskInputBindingSchemaInput>>>>;
     taskPresetKey: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     url: z.ZodString;
     userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/harness/run-create.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 { EnrichmentModeSchema } from "../enrichment/mode.js";
+import { HarnessTaskInputBindingSchema } from "./task-input-binding.js";
 import { ResearchFindingSchema } from "../research/finding.js";
 const HarnessRunCreateSchemaDefinition = z.object({
     /** Facts you already read verbatim on an external source page for an entity, each citing the page and exact text that support it. Omit taskPresetKey to default to apply-cited-findings, or send a preset from GET /v1/research/runs/presets; the run checks each quote against its page and writes only the facts it confirms. When the detail comes from an indexed news article or a page not read verbatim, send userPrompt instead. */
@@ -11,6 +12,8 @@ const HarnessRunCreateSchemaDefinition = z.object({
     model: z.string().nullish(),
     /** Name of the subject at url, such as Clarity Health; the run verifies it and uses it to pick the right subject when the site names several */
     name: z.string().max(200).nullish(),
+    /** Requester values keyed by the selected task's input definitions. ENTITY binds from url and a supplied entityId must match it. TEXT requires explicit text; a missing required or ambiguous supplied value is rejected before enqueue; omitted optional inputs stay unbound. Never infer values from userPrompt. */
+    taskInput: z.array(HarnessTaskInputBindingSchema).optional(),
     /** Research presets that focus the run, listed by GET /v1/research/runs/presets; omit them for a full run */
     taskPresetKey: z.array(z.string()).nullish(),
     /** Official website or profile URL of the company, Product, Service, or person to research; a URL no current record owns researches a new one */

package/dist/harness/task-fact.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+/**
+ * One source-bound fact the requester asks the task run to research.
+ *
+ * @openapiSchema HarnessTaskFact
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessTaskInputBindingSchema
+ * @contractShape harness.task-fact
+ * @contractRole canonical
+ */
+export declare const HarnessTaskFactSchema: z.ZodObject<{
+    eventDate: z.ZodOptional<z.ZodNullable<z.ZodISODate>>;
+    sourceUrl: z.ZodString;
+    statement: z.ZodString;
+}, z.core.$strip>;
+export type HarnessTaskFact = z.infer<typeof HarnessTaskFactSchema>;
+//# sourceMappingURL=task-fact.d.ts.map

package/dist/harness/task-fact.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";
+/**
+ * One source-bound fact the requester asks the task run to research.
+ *
+ * @openapiSchema HarnessTaskFact
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessTaskInputBindingSchema
+ * @contractShape harness.task-fact
+ * @contractRole canonical
+ */
+export const HarnessTaskFactSchema = z.object({
+    /** Date of the event, when known. */
+    eventDate: z.iso.date().nullish(),
+    /** Absolute http or https URL of the page supporting the fact. */
+    sourceUrl: z.string(),
+    /** The single fact to research; non-blank and bounded by the task-input text limit. */
+    statement: z.string(),
+});
+//# sourceMappingURL=task-fact.js.map

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

@@ -0,0 +1,124 @@
+import { z } from "zod/v4";
+declare const HarnessTaskInputBindingSchemaDefinition: z.ZodObject<{
+    entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    fact: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        eventDate: z.ZodOptional<z.ZodNullable<z.ZodISODate>>;
+        sourceUrl: z.ZodString;
+        statement: z.ZodString;
+    }, z.core.$strip>>>;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    newsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    writerBrief: 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.ZodOptional<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>>;
+            section: z.ZodArray<z.ZodType<{
+                judgment: {
+                    claim: number[];
+                    statement: string;
+                };
+                label: string;
+            }, import("../writer/analysis-section.ts").WriterAnalysisSectionSchemaInput, z.core.$ZodTypeInternals<{
+                judgment: {
+                    claim: number[];
+                    statement: string;
+                };
+                label: string;
+            }, import("../writer/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("../writer/paragraph.ts").WriterParagraphSchemaInput, z.core.$ZodTypeInternals<{
+            analysis?: {
+                answer: boolean;
+                section: string[];
+            } | undefined;
+            claim: number[];
+            positioning?: string[] | undefined;
+        }, import("../writer/paragraph.ts").WriterParagraphSchemaInput>>>;
+        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>>>;
+}, z.core.$strip>;
+type HarnessTaskInputBindingDefinition = z.infer<typeof HarnessTaskInputBindingSchemaDefinition>;
+export interface HarnessTaskInputBindingSchemaInput extends z.input<typeof HarnessTaskInputBindingSchemaDefinition> {
+}
+/**
+ * One task input value bound before the run starts; the server validates its key and type.
+ *
+ * @openapiSchema HarnessTaskInputBinding
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessRunCreateSchema
+ * @contractShape harness.task-input-binding
+ * @contractRole canonical
+ */
+export declare const HarnessTaskInputBindingSchema: z.ZodType<HarnessTaskInputBindingDefinition, HarnessTaskInputBindingSchemaInput>;
+export type HarnessTaskInputBinding = z.infer<typeof HarnessTaskInputBindingSchema>;
+export {};
+//# sourceMappingURL=task-input-binding.d.ts.map

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

@@ -0,0 +1,30 @@
+// 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 { 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(),
+    /** 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. */
+    key: z.string().nullish(),
+    /** Canonical news id; exclusive with entityId, text, writerBrief and fact. */
+    newsId: z.int().nullish(),
+    /** Literal requester text; exclusive with entityId, newsId, writerBrief and fact. */
+    text: z.string().nullish(),
+    /** Typed writer brief for a WRITER_BRIEF input; exclusive with entityId, newsId, text and fact. */
+    writerBrief: WriterBriefSchema.nullish(),
+});
+/**
+ * One task input value bound before the run starts; the server validates its key and type.
+ *
+ * @openapiSchema HarnessTaskInputBinding
+ * @endpoint POST /v1/research-runs
+ * @endpoint POST /v1/research/runs
+ * @usedBySchema HarnessRunCreateSchema
+ * @contractShape harness.task-input-binding
+ * @contractRole canonical
+ */
+export const HarnessTaskInputBindingSchema = HarnessTaskInputBindingSchemaDefinition;
+//# sourceMappingURL=task-input-binding.js.map

package/dist/openapi-component-manifest.js

@@ -694,7 +694,12 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     HarnessRunStatus: { modulePath: "harness/run-status", schemaName: "HarnessRunStatusSchema" },
     HarnessRunTurn: { modulePath: "harness/run-turn", schemaName: "HarnessRunTurnSchema" },
     HarnessRunType: { modulePath: "harness/run-type", schemaName: "HarnessRunTypeSchema" },
+    HarnessTaskFact: { modulePath: "harness/task-fact", schemaName: "HarnessTaskFactSchema" },
     HarnessTaskInput: { modulePath: "harness/task", schemaName: "HarnessTaskSchema" },
+    HarnessTaskInputBinding: {
+        modulePath: "harness/task-input-binding",
+        schemaName: "HarnessTaskInputBindingSchema",
+    },
     HarnessTaskInputType: {
         modulePath: "harness/task-input-type",
         schemaName: "HarnessTaskInputTypeSchema",

package/dist/person/similar-param.js

@@ -16,6 +16,6 @@ export const PersonSimilarParamSchema = z.object({
     /** Permit monogram fallback */
     permitMonogram: z.boolean().optional(),
     /** The size of the page to be returned */
-    size: z.int().min(1).default(10).optional(),
+    size: z.int().min(1).default(20).optional(),
 });
 //# sourceMappingURL=similar-param.js.map

package/dist/research/paragraph-shape.d.ts

@@ -13,6 +13,7 @@ import { z } from "zod/v4";
  */
 export declare const ResearchParagraphShapeSchema: z.ZodObject<{
     maxChars: z.ZodInt;
+    maxClaimWords: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     maxParagraphs: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     maxSentences: z.ZodInt;
     minChars: z.ZodInt;

package/dist/research/paragraph-shape.js

@@ -15,6 +15,8 @@ import { z } from "zod/v4";
 export const ResearchParagraphShapeSchema = z.object({
     /** Maximum characters per paragraph (inclusive). */
     maxChars: z.int(),
+    /** Maximum words across the statements of the claims one planned writer paragraph states (paragraph.claim); null means unbounded. */
+    maxClaimWords: z.int().nullish(),
     /** Maximum paragraph count (inclusive); null means unbounded. */
     maxParagraphs: z.int().nullish(),
     /** Maximum sentences per paragraph (inclusive). */

package/dist/research/snippet-type.d.ts

@@ -19,6 +19,7 @@ declare const ResearchSnippetTypeSchemaDefinition: z.ZodObject<{
     minLength: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     paragraphShape: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         maxChars: z.ZodInt;
+        maxClaimWords: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         maxParagraphs: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         maxSentences: z.ZodInt;
         minChars: z.ZodInt;

package/dist/text/type-option.d.ts

@@ -5,6 +5,7 @@ declare const TextTypeOptionSchemaDefinition: z.ZodObject<{
     minWords: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     paragraphShape: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         maxChars: z.ZodInt;
+        maxClaimWords: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         maxParagraphs: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         maxSentences: z.ZodInt;
         minChars: z.ZodInt;

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

@@ -16,6 +16,8 @@ export interface WriterAnalysisSectionSchemaInput extends z.input<typeof WriterA
  * One ordered framework judgment.
  *
  * @openapiSchema WriterAnalysisSection
+ * @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 WriterMetaAnalysisSchema

package/dist/writer/analysis-section.js

@@ -11,6 +11,8 @@ const WriterAnalysisSectionSchemaDefinition = z.object({
  * One ordered framework judgment.
  *
  * @openapiSchema WriterAnalysisSection
+ * @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 WriterMetaAnalysisSchema

package/dist/writer/brief.d.ts

@@ -3,9 +3,12 @@ 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 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 EntityAnalysisSectionMutationSchema
+ * @usedBySchema HarnessTaskInputBindingSchema
  * @contractShape writer.brief
  * @contractRole canonical
  */

package/dist/writer/brief.js

@@ -8,9 +8,12 @@ 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 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 EntityAnalysisSectionMutationSchema
+ * @usedBySchema HarnessTaskInputBindingSchema
  * @contractShape writer.brief
  * @contractRole canonical
  */

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

@@ -10,6 +10,8 @@ export interface WriterChangeSignalSchemaInput extends z.input<typeof WriterChan
  * Evidence that would change the supplied judgment.
  *
  * @openapiSchema WriterChangeSignal
+ * @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 WriterMetaAnalysisSchema

package/dist/writer/change-signal.js

@@ -10,6 +10,8 @@ const WriterChangeSignalSchemaDefinition = z.object({
  * Evidence that would change the supplied judgment.
  *
  * @openapiSchema WriterChangeSignal
+ * @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 WriterMetaAnalysisSchema

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

@@ -3,6 +3,8 @@ import { z } from "zod/v4";
  * Reason a research gap remains unresolved.
  *
  * @openapiSchema WriterGapReason
+ * @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 WriterGapSchema

package/dist/writer/gap-reason.js

@@ -10,6 +10,8 @@ const WriterGapReasonSchemaKnownMembers = z.enum([
  * Reason a research gap remains unresolved.
  *
  * @openapiSchema WriterGapReason
+ * @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 WriterGapSchema

package/dist/writer/gap.d.ts

@@ -23,6 +23,8 @@ export interface WriterGapSchemaInput extends z.input<typeof WriterGapSchemaDefi
  * A known evidence gap or conflict.
  *
  * @openapiSchema WriterGap
+ * @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 WriterMetaAnalysisSchema

package/dist/writer/gap.js

@@ -13,6 +13,8 @@ const WriterGapSchemaDefinition = z.object({
  * A known evidence gap or conflict.
  *
  * @openapiSchema WriterGap
+ * @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 WriterMetaAnalysisSchema

package/dist/writer/judgment.d.ts

@@ -10,6 +10,8 @@ export interface WriterJudgmentSchemaInput extends z.input<typeof WriterJudgment
  * One sourced research judgment.
  *
  * @openapiSchema WriterJudgment
+ * @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 WriterAnalysisSectionSchema

package/dist/writer/judgment.js

@@ -10,6 +10,8 @@ const WriterJudgmentSchemaDefinition = z.object({
  * One sourced research judgment.
  *
  * @openapiSchema WriterJudgment
+ * @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 WriterAnalysisSectionSchema

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

@@ -3,6 +3,8 @@ import { z } from "zod/v4";
  * Research judgment the writer must preserve.
  *
  * @openapiSchema WriterMetaAnalysis
+ * @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 WriterBriefSchema

package/dist/writer/meta-analysis.js

@@ -9,6 +9,8 @@ import { WriterScopeSchema } from "./scope.js";
  * Research judgment the writer must preserve.
  *
  * @openapiSchema WriterMetaAnalysis
+ * @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 WriterBriefSchema

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

@@ -3,6 +3,8 @@ import { z } from "zod/v4";
  * Meta-analysis judgments assigned to one paragraph.
  *
  * @openapiSchema WriterParagraphAnalysis
+ * @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 WriterParagraphSchema

package/dist/writer/paragraph-analysis.js

@@ -4,6 +4,8 @@ import { z } from "zod/v4";
  * Meta-analysis judgments assigned to one paragraph.
  *
  * @openapiSchema WriterParagraphAnalysis
+ * @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 WriterParagraphSchema

package/dist/writer/paragraph.d.ts

@@ -28,6 +28,8 @@ export interface WriterParagraphSchemaInput extends z.input<typeof WriterParagra
  * One planned paragraph.
  *
  * @openapiSchema WriterParagraph
+ * @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 WriterBriefSchema

package/dist/writer/paragraph.js

@@ -14,6 +14,8 @@ const WriterParagraphSchemaDefinition = z.object({
  * One planned paragraph.
  *
  * @openapiSchema WriterParagraph
+ * @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 WriterBriefSchema

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

@@ -3,6 +3,8 @@ import { z } from "zod/v4";
  * Research-selected category, buyer, approach, differentiation, or alternative.
  *
  * @openapiSchema WriterPositioningElement
+ * @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 WriterParagraphSchema

package/dist/writer/positioning-element.js

@@ -11,6 +11,8 @@ const WriterPositioningElementSchemaKnownMembers = z.enum([
  * Research-selected category, buyer, approach, differentiation, or alternative.
  *
  * @openapiSchema WriterPositioningElement
+ * @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 WriterParagraphSchema

package/dist/writer/positioning.d.ts

@@ -25,6 +25,8 @@ export interface WriterPositioningSchemaInput extends z.input<typeof WriterPosit
  * One positioning decision and supporting claims.
  *
  * @openapiSchema WriterPositioning
+ * @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 WriterBriefSchema

package/dist/writer/positioning.js

@@ -13,6 +13,8 @@ const WriterPositioningSchemaDefinition = z.object({
  * One positioning decision and supporting claims.
  *
  * @openapiSchema WriterPositioning
+ * @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 WriterBriefSchema

package/dist/writer/scope.d.ts

@@ -11,6 +11,8 @@ export interface WriterScopeSchemaInput extends z.input<typeof WriterScopeSchema
  * Research boundary used by a writer brief.
  *
  * @openapiSchema WriterScope
+ * @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 WriterMetaAnalysisSchema

package/dist/writer/scope.js

@@ -12,6 +12,8 @@ const WriterScopeSchemaDefinition = z.object({
  * Research boundary used by a writer brief.
  *
  * @openapiSchema WriterScope
+ * @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 WriterMetaAnalysisSchema

package/package.json

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