@aventurevc/api-schemas 0.8.201 → 0.8.204

package/dist/agent/help.d.ts

@@ -60,6 +60,7 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
                 step: {
                     instruction: string;
                     operationId: string;
+                    planTaskKey?: string[] | undefined;
                     stepKey?: string | undefined;
                 };
                 writeGuidance?: {
@@ -76,6 +77,7 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
                 step: {
                     instruction: string;
                     operationId: string;
+                    planTaskKey?: string[] | undefined;
                     stepKey?: string | undefined;
                 };
                 writeGuidance?: {

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/harness/task-plan-step.d.ts

@@ -5,10 +5,12 @@ declare const HarnessTaskPlanStepSchemaDefinition: z.ZodObject<{
     step: z.ZodType<{
         instruction: string;
         operationId: string;
+        planTaskKey?: string[] | undefined;
         stepKey?: string | undefined;
     }, import("./task-step.ts").HarnessTaskStepSchemaInput, z.core.$ZodTypeInternals<{
         instruction: string;
         operationId: string;
+        planTaskKey?: string[] | undefined;
         stepKey?: string | undefined;
     }, import("./task-step.ts").HarnessTaskStepSchemaInput>>;
     writeGuidance: z.ZodOptional<z.ZodNullable<z.ZodObject<{

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

@@ -31,6 +31,7 @@ export declare const HarnessTaskPlanSchema: z.ZodObject<{
         step: {
             instruction: string;
             operationId: string;
+            planTaskKey?: string[] | undefined;
             stepKey?: string | undefined;
         };
         writeGuidance?: {
@@ -47,6 +48,7 @@ export declare const HarnessTaskPlanSchema: z.ZodObject<{
         step: {
             instruction: string;
             operationId: string;
+            planTaskKey?: string[] | undefined;
             stepKey?: string | undefined;
         };
         writeGuidance?: {

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

@@ -2,13 +2,14 @@ import { z } from "zod/v4";
 declare const HarnessTaskStepSchemaDefinition: z.ZodObject<{
     instruction: z.ZodString;
     operationId: z.ZodString;
+    planTaskKey: z.ZodOptional<z.ZodArray<z.ZodString>>;
     stepKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type HarnessTaskStepDefinition = z.infer<typeof HarnessTaskStepSchemaDefinition>;
 export interface HarnessTaskStepSchemaInput extends z.input<typeof HarnessTaskStepSchemaDefinition> {
 }
 /**
- * One ordered task step: its key, instruction, and the operation that runs it.
+ * One ordered task step: its key, instruction, the operation that runs it, and the delegated plans it follows.
  *
  * @openapiSchema HarnessTaskStep
  * @endpoint POST /v1/agents/help

package/dist/harness/task-step.js

@@ -5,11 +5,13 @@ const HarnessTaskStepSchemaDefinition = z.object({
     instruction: z.string(),
     /** OpenAPI operationId this step calls; it must be in the task's operation list. */
     operationId: z.string(),
+    /** Agent-task keys whose plans this step follows instead of restating their steps: the task then owns each named plan's steps, so a write one of them commits counts for this task too. Each must name another planned task; a key may appear once per task and delegations must not loop. */
+    planTaskKey: z.array(z.string()).optional(),
     /** Step key, unique within its task. */
     stepKey: z.string().optional(),
 });
 /**
- * One ordered task step: its key, instruction, and the operation that runs it.
+ * One ordered task step: its key, instruction, the operation that runs it, and the delegated plans it follows.
  *
  * @openapiSchema HarnessTaskStep
  * @endpoint POST /v1/agents/help

package/dist/help/resolution.d.ts

@@ -52,6 +52,7 @@ export declare const HelpResolutionSchema: z.ZodObject<{
             step: {
                 instruction: string;
                 operationId: string;
+                planTaskKey?: string[] | undefined;
                 stepKey?: string | undefined;
             };
             writeGuidance?: {
@@ -68,6 +69,7 @@ export declare const HelpResolutionSchema: z.ZodObject<{
             step: {
                 instruction: string;
                 operationId: string;
+                planTaskKey?: string[] | undefined;
                 stepKey?: string | undefined;
             };
             writeGuidance?: {

package/dist/http/problem-detail.d.ts

@@ -66,6 +66,7 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         origin_detail_shutdown: "origin_detail_shutdown";
         primary_website_missing: "primary_website_missing";
         prose_rejected: "prose_rejected";
+        query_deadline_shed: "query_deadline_shed";
         r2_delete_failed: "r2_delete_failed";
         r2_fetch_failed: "r2_fetch_failed";
         r2_upload_failed: "r2_upload_failed";

package/dist/http/problem-detail.js

@@ -41,6 +41,8 @@ const ProblemDetailSchemaDefinition = z.object({
             "origin_detail_capacity",
             /** Detail-origin cold-miss scheduler rejected work because this instance is shutting down for a redeploy. Agent action: retry shortly; the platform routes the retry to a healthy instance. This is deploy-window noise, not a capacity defect — do not treat it as backend saturation. */
             "origin_detail_shutdown",
+            /** A read overran its database query budget and was shed before it could answer, so nothing was read and the identical request can be replayed. Agent action: retry after a short backoff; this service records the shed WARN-only without an incident, so a consumer that reports it files the only incident for an expected condition. */
+            "query_deadline_shed",
             /** Request prose looks shell-mangled around a money phrase: either shell expansion stripped a leading dollar sign ('50 million' where '$50 million' was meant) or an escape character survived into the text ('\$50 million', standalone '/$50 million'). Agent action: write '$' literally and re-send the JSON body from a file or stdin, or quote it so the shell does not expand '$'; use allowSuspectedShellStrip only when the value is intentional. */
             "suspectedShellStrip",
             /** Request prose looks shell-mangled around a money phrase: either shell expansion stripped a leading dollar sign ('50 million' where '$50 million' was meant) or an escape character survived into the text ('\$50 million', standalone '/$50 million'). Agent action: write '$' literally and re-send the JSON body from a file or stdin, or quote it so the shell does not expand '$'; use allowSuspectedShellStrip only when the value is intentional. */

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.204",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",