@aventurevc/api-schemas 0.8.260 → 0.8.262

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

package/dist/writer/positioning.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 { WriterPositioningElementSchema } from "./positioning-element.js";
+const WriterPositioningSchemaDefinition = z.object({
+    /** Supporting evidence claim numbers. */
+    claim: z.array(z.int()),
+    /** Positioning element decided by research. */
+    element: WriterPositioningElementSchema,
+    /** Position in plain words. */
+    statement: z.string(),
+});
+/**
+ * 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 const WriterPositioningSchema = WriterPositioningSchemaDefinition;
+//# sourceMappingURL=positioning.js.map

package/dist/writer/scope.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v4";
+declare const WriterScopeSchemaDefinition: z.ZodObject<{
+    boundary: z.ZodString;
+    geography: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    period: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type WriterScopeDefinition = z.infer<typeof WriterScopeSchemaDefinition>;
+export interface WriterScopeSchemaInput extends z.input<typeof WriterScopeSchemaDefinition> {
+}
+/**
+ * Research boundary used by a writer brief.
+ *
+ * @openapiSchema WriterScope
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.scope
+ * @contractRole canonical
+ */
+export declare const WriterScopeSchema: z.ZodType<WriterScopeDefinition, WriterScopeSchemaInput>;
+export type WriterScope = z.infer<typeof WriterScopeSchema>;
+export {};
+//# sourceMappingURL=scope.d.ts.map

package/dist/writer/scope.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 WriterScopeSchemaDefinition = z.object({
+    /** Market, company, or question boundary. */
+    boundary: z.string(),
+    /** Geography when the evidence is geographically bounded. */
+    geography: z.string().nullish(),
+    /** Research period when the evidence is time-bounded. */
+    period: z.string().nullish(),
+});
+/**
+ * Research boundary used by a writer brief.
+ *
+ * @openapiSchema WriterScope
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema WriterMetaAnalysisSchema
+ * @contractShape writer.scope
+ * @contractRole canonical
+ */
+export const WriterScopeSchema = WriterScopeSchemaDefinition;
+//# sourceMappingURL=scope.js.map

package/package.json

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

package/dist/system/status.d.ts

@@ -1,19 +0,0 @@
-import { z } from "zod/v4";
-declare const SystemStatusSchemaDefinition: z.ZodObject<{
-    operationFingerprint: z.ZodString;
-}, z.core.$strip>;
-type SystemStatusDefinition = z.infer<typeof SystemStatusSchemaDefinition>;
-export interface SystemStatusSchemaInput extends z.input<typeof SystemStatusSchemaDefinition> {
-}
-/**
- * System status reported by the API
- *
- * @openapiSchema SystemStatus
- * @endpoint GET /v1/status
- * @contractShape system.status
- * @contractRole canonical
- */
-export declare const SystemStatusSchema: z.ZodType<SystemStatusDefinition, SystemStatusSchemaInput>;
-export type SystemStatus = z.infer<typeof SystemStatusSchema>;
-export {};
-//# sourceMappingURL=status.d.ts.map

package/dist/system/status.js

@@ -1,16 +0,0 @@
-// 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 SystemStatusSchemaDefinition = z.object({
-    /** Short hash identifying the exact set of operations this deployment serves. A generated client stamps the same value from the OpenAPI document it was built from; an unequal value means the client catalog is stale. */
-    operationFingerprint: z.string(),
-});
-/**
- * System status reported by the API
- *
- * @openapiSchema SystemStatus
- * @endpoint GET /v1/status
- * @contractShape system.status
- * @contractRole canonical
- */
-export const SystemStatusSchema = SystemStatusSchemaDefinition;
-//# sourceMappingURL=status.js.map