@aventurevc/api-schemas 0.8.425 → 0.8.427

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

@@ -175,6 +175,23 @@ declare const HarnessRunDetailSchemaDefinition: z.ZodObject<{
         updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     }, z.core.$strip>>>;
     publicUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    report: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        paragraph: z.ZodArray<z.ZodType<{
+            source: {
+                quote: string;
+                title?: string | null | undefined;
+                url: string;
+            }[];
+            text: string;
+        }, import("../research/run-report-paragraph.ts").ResearchRunReportParagraphSchemaInput, z.core.$ZodTypeInternals<{
+            source: {
+                quote: string;
+                title?: string | null | undefined;
+                url: string;
+            }[];
+            text: string;
+        }, import("../research/run-report-paragraph.ts").ResearchRunReportParagraphSchemaInput>>>;
+    }, z.core.$strip>>>;
     run: z.ZodObject<{
         attempt: z.ZodInt;
         callerCanFollowRun: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/harness/run-detail.js

@@ -4,6 +4,7 @@ import { EntitySchema } from "../entity/entity.js";
 import { HarnessRunFollowUpSchema } from "./run-follow-up.js";
 import { HarnessRunProgressSchema } from "./run-progress.js";
 import { HarnessRunSchema } from "./run.js";
+import { ResearchRunReportSchema } from "../research/run-report.js";
 const HarnessRunDetailSchemaDefinition = z.object({
     /** Current public profile the run resolved to */
     entity: EntitySchema.nullish(),
@@ -17,6 +18,8 @@ const HarnessRunDetailSchemaDefinition = z.object({
     provider: EntitySchema.nullish(),
     /** Exact renderable public profile URL for the resolved entity */
     publicUrl: z.string().nullish(),
+    /** Written report and its citations, when the run submitted one */
+    report: ResearchRunReportSchema.nullish(),
     /** The research run */
     run: HarnessRunSchema,
 });

package/dist/http/problem-detail.js

@@ -88,7 +88,7 @@ export const ProblemDetailSchema = z.object({
             "JOBRUNR_DISABLED",
             /** JobRunr background worker is disabled in this environment. Agent action: stop (this is an admin/ops configuration condition, not a retriable user error). */
             "jobrunr_disabled",
-            /** A catalog task step runs an operation this API instance does not serve, so its plan cannot be projected: rollout skew, or an instance whose configuration disables that operation. Agent action: retry after the rollout; on a deployed instance that persists, report it as rollout skew. */
+            /** A catalog task step names an operation this API instance's command catalog does not expose, so its plan cannot be projected. Causes include rollout skew, configuration or a removed operation. Agent action: have an operator check the selected task catalog and deployed operation list before retrying; do not assume a rollout will restore it. */
             "task_plan_operation_unserved",
             /** JobRunr storage (Postgres) is down. Agent action: stop until it recovers. */
             "JOBRUNR_STORAGE_UNAVAILABLE",

package/dist/openapi-component-manifest.js

@@ -1157,6 +1157,15 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "research/paragraph-shape",
         schemaName: "ResearchParagraphShapeSchema",
     },
+    ResearchRunReport: { modulePath: "research/run-report", schemaName: "ResearchRunReportSchema" },
+    ResearchRunReportParagraph: {
+        modulePath: "research/run-report-paragraph",
+        schemaName: "ResearchRunReportParagraphSchema",
+    },
+    ResearchRunReportSource: {
+        modulePath: "research/run-report-source",
+        schemaName: "ResearchRunReportSourceSchema",
+    },
     ResearchRunView: { modulePath: "research/run-view", schemaName: "ResearchRunViewSchema" },
     ResearchSnippetType: {
         modulePath: "research/snippet-type",

package/dist/research/run-report-paragraph.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+declare const ResearchRunReportParagraphSchemaDefinition: z.ZodObject<{
+    source: z.ZodArray<z.ZodType<{
+        quote: string;
+        title?: string | null | undefined;
+        url: string;
+    }, import("./run-report-source.ts").ResearchRunReportSourceSchemaInput, z.core.$ZodTypeInternals<{
+        quote: string;
+        title?: string | null | undefined;
+        url: string;
+    }, import("./run-report-source.ts").ResearchRunReportSourceSchemaInput>>>;
+    text: z.ZodString;
+}, z.core.$strip>;
+type ResearchRunReportParagraphDefinition = z.infer<typeof ResearchRunReportParagraphSchemaDefinition>;
+export interface ResearchRunReportParagraphSchemaInput extends z.input<typeof ResearchRunReportParagraphSchemaDefinition> {
+}
+/**
+ * One paragraph and its supporting sources
+ *
+ * @openapiSchema ResearchRunReportParagraph
+ * @endpoint GET /v1/research/runs/{runId}
+ * @usedBySchema ResearchRunReportSchema
+ * @contractShape research.run-report-paragraph
+ * @contractRole canonical
+ */
+export declare const ResearchRunReportParagraphSchema: z.ZodType<ResearchRunReportParagraphDefinition, ResearchRunReportParagraphSchemaInput>;
+export type ResearchRunReportParagraph = z.infer<typeof ResearchRunReportParagraphSchema>;
+export {};
+//# sourceMappingURL=run-report-paragraph.d.ts.map

package/dist/research/run-report-paragraph.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";
+import { ResearchRunReportSourceSchema } from "./run-report-source.js";
+const ResearchRunReportParagraphSchemaDefinition = z.object({
+    /** Sources supporting the claims in this paragraph */
+    source: z.array(ResearchRunReportSourceSchema),
+    /** Written finding */
+    text: z.string(),
+});
+/**
+ * One paragraph and its supporting sources
+ *
+ * @openapiSchema ResearchRunReportParagraph
+ * @endpoint GET /v1/research/runs/{runId}
+ * @usedBySchema ResearchRunReportSchema
+ * @contractShape research.run-report-paragraph
+ * @contractRole canonical
+ */
+export const ResearchRunReportParagraphSchema = ResearchRunReportParagraphSchemaDefinition;
+//# sourceMappingURL=run-report-paragraph.js.map

package/dist/research/run-report-source.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const ResearchRunReportSourceSchemaDefinition: z.ZodObject<{
+    quote: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodString;
+}, z.core.$strip>;
+type ResearchRunReportSourceDefinition = z.infer<typeof ResearchRunReportSourceSchemaDefinition>;
+export interface ResearchRunReportSourceSchemaInput extends z.input<typeof ResearchRunReportSourceSchemaDefinition> {
+}
+/**
+ * A page and verbatim evidence supporting a report paragraph
+ *
+ * @openapiSchema ResearchRunReportSource
+ * @endpoint GET /v1/research/runs/{runId}
+ * @usedBySchema ResearchRunReportParagraphSchema
+ * @contractShape research.run-report-source
+ * @contractRole canonical
+ */
+export declare const ResearchRunReportSourceSchema: z.ZodType<ResearchRunReportSourceDefinition, ResearchRunReportSourceSchemaInput>;
+export type ResearchRunReportSource = z.infer<typeof ResearchRunReportSourceSchema>;
+export {};
+//# sourceMappingURL=run-report-source.d.ts.map

package/dist/research/run-report-source.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 ResearchRunReportSourceSchemaDefinition = z.object({
+    /** Verbatim quote from the page that supports the paragraph */
+    quote: z.string(),
+    /** Title of the page, when available */
+    title: z.string().nullish(),
+    /** Absolute HTTP or HTTPS URL of the page quoted */
+    url: z.string(),
+});
+/**
+ * A page and verbatim evidence supporting a report paragraph
+ *
+ * @openapiSchema ResearchRunReportSource
+ * @endpoint GET /v1/research/runs/{runId}
+ * @usedBySchema ResearchRunReportParagraphSchema
+ * @contractShape research.run-report-source
+ * @contractRole canonical
+ */
+export const ResearchRunReportSourceSchema = ResearchRunReportSourceSchemaDefinition;
+//# sourceMappingURL=run-report-source.js.map

package/dist/research/run-report.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+/**
+ * Written research with evidence for each paragraph
+ *
+ * @openapiSchema ResearchRunReport
+ * @endpoint GET /v1/research/runs/{runId}
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape research.run-report
+ * @contractRole canonical
+ */
+export declare const ResearchRunReportSchema: z.ZodObject<{
+    paragraph: z.ZodArray<z.ZodType<{
+        source: {
+            quote: string;
+            title?: string | null | undefined;
+            url: string;
+        }[];
+        text: string;
+    }, import("./run-report-paragraph.ts").ResearchRunReportParagraphSchemaInput, z.core.$ZodTypeInternals<{
+        source: {
+            quote: string;
+            title?: string | null | undefined;
+            url: string;
+        }[];
+        text: string;
+    }, import("./run-report-paragraph.ts").ResearchRunReportParagraphSchemaInput>>>;
+}, z.core.$strip>;
+export type ResearchRunReport = z.infer<typeof ResearchRunReportSchema>;
+//# sourceMappingURL=run-report.d.ts.map

package/dist/research/run-report.js

@@ -0,0 +1,17 @@
+// 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 { ResearchRunReportParagraphSchema } from "./run-report-paragraph.js";
+/**
+ * Written research with evidence for each paragraph
+ *
+ * @openapiSchema ResearchRunReport
+ * @endpoint GET /v1/research/runs/{runId}
+ * @usedBySchema HarnessRunDetailSchema
+ * @contractShape research.run-report
+ * @contractRole canonical
+ */
+export const ResearchRunReportSchema = z.object({
+    /** Cited paragraphs in reading order */
+    paragraph: z.array(ResearchRunReportParagraphSchema),
+});
+//# sourceMappingURL=run-report.js.map

package/package.json

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