@aventurevc/api-schemas 0.8.201 → 0.8.203

package/dist/enrichment/prompt.d.ts

@@ -5,11 +5,13 @@ declare const EnrichmentPromptSchemaDefinition: z.ZodObject<{
         quote: string;
         sourceUrl: string;
         statement: string;
+        writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         gateId?: string | null | undefined;
         quote: string;
         sourceUrl: string;
         statement: string;
+        writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>>>;
     userPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;

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

@@ -5,11 +5,13 @@ declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
         quote: string;
         sourceUrl: string;
         statement: string;
+        writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
         gateId?: string | null | undefined;
         quote: string;
         sourceUrl: string;
         statement: string;
+        writerSurface?: string | null | undefined;
     }, import("../research/finding.ts").ResearchFindingSchemaInput>>>>>;
     mode: z.ZodOptional<z.ZodEnum<{
         COMPREHENSIVE: "COMPREHENSIVE";

package/dist/openapi-component-manifest.js

@@ -1078,5 +1078,9 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     ValuationType: { modulePath: "valuation/type", schemaName: "ValuationTypeSchema" },
     WebSearch: { modulePath: "web/search", schemaName: "WebSearchSchema" },
     WebSearchProvider: { modulePath: "web/search-provider", schemaName: "WebSearchProviderSchema" },
+    WriterClaimSurface: {
+        modulePath: "writer/claim-surface",
+        schemaName: "WriterClaimSurfaceSchema",
+    },
 });
 //# sourceMappingURL=openapi-component-manifest.js.map

package/dist/research/finding.d.ts

@@ -4,6 +4,17 @@ declare const ResearchFindingSchemaDefinition: z.ZodObject<{
     quote: z.ZodString;
     sourceUrl: z.ZodString;
     statement: z.ZodString;
+    writerSurface: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        BOTH: "BOTH";
+        ENTITY_TEXT: "ENTITY_TEXT";
+        RESEARCH_SNIPPET: "RESEARCH_SNIPPET";
+    }>, z.ZodString]> & {
+        enum: {
+            BOTH: "BOTH";
+            ENTITY_TEXT: "ENTITY_TEXT";
+            RESEARCH_SNIPPET: "RESEARCH_SNIPPET";
+        };
+    }>>;
 }, z.core.$strip>;
 type ResearchFindingDefinition = z.infer<typeof ResearchFindingSchemaDefinition>;
 export interface ResearchFindingSchemaInput extends z.input<typeof ResearchFindingSchemaDefinition> {

package/dist/research/finding.js

@@ -1,5 +1,6 @@
 // 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 { WriterClaimSurfaceSchema } from "../writer/claim-surface.js";
 const ResearchFindingSchemaDefinition = z.object({
     /** Profile field the fact fills, when known; omit it and the run picks the field the fact belongs to. */
     gateId: z.string().nullish(),
@@ -9,6 +10,8 @@ const ResearchFindingSchemaDefinition = z.object({
     sourceUrl: z.string(),
     /** The fact to write, in plain words. */
     statement: z.string(),
+    /** Surface this sourced claim may enter: durable entity text, point-in-time research snippets, or both. New writer briefs must declare it. */
+    writerSurface: WriterClaimSurfaceSchema.nullish(),
 });
 /**
  * One fact you researched, with the page and exact text that support it. The run checks the quote against the page before it writes the fact.

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

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+/**
+ * Output surface selected for a sourced writer claim.
+ *
+ * @openapiSchema WriterClaimSurface
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/research-runs
+ * @usedBySchema ResearchFindingSchema
+ * @contractShape writer.claim-surface
+ * @contractRole canonical
+ */
+export declare const WriterClaimSurfaceSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    BOTH: "BOTH";
+    ENTITY_TEXT: "ENTITY_TEXT";
+    RESEARCH_SNIPPET: "RESEARCH_SNIPPET";
+}>, z.ZodString]> & {
+    enum: {
+        BOTH: "BOTH";
+        ENTITY_TEXT: "ENTITY_TEXT";
+        RESEARCH_SNIPPET: "RESEARCH_SNIPPET";
+    };
+};
+export type WriterClaimSurface = z.infer<typeof WriterClaimSurfaceSchema>;
+//# sourceMappingURL=claim-surface.d.ts.map

package/dist/writer/claim-surface.js

@@ -0,0 +1,15 @@
+// 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 WriterClaimSurfaceSchemaKnownMembers = z.enum(["ENTITY_TEXT", "RESEARCH_SNIPPET", "BOTH"]);
+/**
+ * Output surface selected for a sourced writer claim.
+ *
+ * @openapiSchema WriterClaimSurface
+ * @endpoint POST /v1/entities/{entityId}/enrichments
+ * @endpoint POST /v1/research-runs
+ * @usedBySchema ResearchFindingSchema
+ * @contractShape writer.claim-surface
+ * @contractRole canonical
+ */
+export const WriterClaimSurfaceSchema = Object.assign(z.union([WriterClaimSurfaceSchemaKnownMembers, z.string()]), { enum: WriterClaimSurfaceSchemaKnownMembers.enum });
+//# sourceMappingURL=claim-surface.js.map

package/package.json

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