@aventurevc/api-schemas 0.8.69 → 0.8.71

package/dist/agent/help.d.ts

@@ -38,6 +38,36 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
         }>;
         probability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         taskKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taskPlan: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            catalogRevision: z.ZodInt;
+            input: z.ZodArray<z.ZodType<{
+                description: string;
+                key: string;
+                type: "ENTITY" | "TEXT";
+            }, unknown, z.core.$ZodTypeInternals<{
+                description: string;
+                key: string;
+                type: "ENTITY" | "TEXT";
+            }, unknown>>>;
+            step: z.ZodArray<z.ZodType<{
+                cliCommand: string;
+                mcpTool?: string | null | undefined;
+                step: {
+                    instruction: string;
+                    operationId: string;
+                    stepKey: string;
+                };
+            }, unknown, z.core.$ZodTypeInternals<{
+                cliCommand: string;
+                mcpTool?: string | null | undefined;
+                step: {
+                    instruction: string;
+                    operationId: string;
+                    stepKey: string;
+                };
+            }, unknown>>>;
+            taskKey: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 type AgentHelpDefinition = z.infer<typeof AgentHelpSchemaDefinition>;

package/dist/federated/search.d.ts

@@ -8,6 +8,16 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 sourceId: string;
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
+            paragraph: {
+                citation: {
+                    entityId: string;
+                    source: "entityRecord" | "newsArticle" | "researchSnippet";
+                    sourceId: string;
+                }[];
+                text: string;
+                topic?: string | null | undefined;
+            }[];
+            relatedQuery: string[];
             text: string;
         } | null | undefined;
         interpretation: {
@@ -2071,6 +2081,16 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 sourceId: string;
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
+            paragraph: {
+                citation: {
+                    entityId: string;
+                    source: "entityRecord" | "newsArticle" | "researchSnippet";
+                    sourceId: string;
+                }[];
+                text: string;
+                topic?: string | null | undefined;
+            }[];
+            relatedQuery: string[];
             text: string;
         } | null | undefined;
         interpretation: {
@@ -4168,6 +4188,33 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         totalElements: number;
         totalPages: number;
     }, unknown>>;
+    newsEntityMention: z.ZodArray<z.ZodType<{
+        entity: {
+            createdAt: string;
+            entityId: string;
+            href?: string | null | undefined;
+            internal: boolean;
+            matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+            mention?: string | null | undefined;
+            slug?: string | null | undefined;
+            typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            updatedAt: string;
+        }[];
+        newsId: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        entity: {
+            createdAt: string;
+            entityId: string;
+            href?: string | null | undefined;
+            internal: boolean;
+            matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+            mention?: string | null | undefined;
+            slug?: string | null | undefined;
+            typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            updatedAt: string;
+        }[];
+        newsId: number;
+    }, unknown>>>;
     person: z.ZodType<{
         interpretation: {
             confidence: "HIGH" | "LOW" | "MEDIUM";

package/dist/federated/search.js

@@ -2,6 +2,7 @@
 import { z } from "zod/v4";
 import { FederatedSearchProvenanceSchema } from "./search-provenance.js";
 import { NaturalSearchResultSchema } from "../natural/search-result.js";
+import { NewsEntityMentionSchema } from "../news/entity-mention.js";
 import { PageResultNewsSchema } from "../pagination/schemas.js";
 import { PersonNaturalSearchResultSchema } from "../person/natural-search-result.js";
 const FederatedSearchSchemaDefinition = z.object({
@@ -9,6 +10,8 @@ const FederatedSearchSchemaDefinition = z.object({
     entity: NaturalSearchResultSchema,
     /** Canonical news page returned by the keyword list engine. */
     news: PageResultNewsSchema,
+    /** Public entities each news row on the page links to, in news page order; a row with no public entity link has no entry. */
+    newsEntityMention: z.array(NewsEntityMentionSchema),
     /** Canonical person natural-search result. */
     person: PersonNaturalSearchResultSchema,
     /** Requested and executed strategy for each search scope. */

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

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states.
+ *
+ * @openapiSchema HarnessTaskInputType
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskSchema
+ * @contractShape harness.task-input-type
+ * @contractRole canonical
+ */
+export declare const HarnessTaskInputTypeSchema: z.ZodEnum<{
+    ENTITY: "ENTITY";
+    TEXT: "TEXT";
+}>;
+export type HarnessTaskInputType = z.infer<typeof HarnessTaskInputTypeSchema>;
+//# sourceMappingURL=task-input-type.d.ts.map

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

@@ -0,0 +1,14 @@
+// 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";
+/**
+ * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states.
+ *
+ * @openapiSchema HarnessTaskInputType
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskSchema
+ * @contractShape harness.task-input-type
+ * @contractRole canonical
+ */
+export const HarnessTaskInputTypeSchema = z.enum(["ENTITY", "TEXT"]);
+//# sourceMappingURL=task-input-type.js.map

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

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+declare const HarnessTaskPlanStepSchemaDefinition: z.ZodObject<{
+    cliCommand: z.ZodString;
+    mcpTool: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    step: z.ZodType<{
+        instruction: string;
+        operationId: string;
+        stepKey: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        instruction: string;
+        operationId: string;
+        stepKey: string;
+    }, unknown>>;
+}, z.core.$strip>;
+type HarnessTaskPlanStepDefinition = z.infer<typeof HarnessTaskPlanStepSchemaDefinition>;
+/**
+ * One task step with the CLI command and MCP tool that run its operation.
+ *
+ * @openapiSchema HarnessTaskPlanStep
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanSchema
+ * @contractShape harness.task-plan-step
+ * @contractRole canonical
+ */
+export declare const HarnessTaskPlanStepSchema: z.ZodType<HarnessTaskPlanStepDefinition>;
+export type HarnessTaskPlanStep = z.infer<typeof HarnessTaskPlanStepSchema>;
+export {};
+//# sourceMappingURL=task-plan-step.d.ts.map

package/dist/harness/task-plan-step.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 { HarnessTaskStepSchema } from "./task-step.js";
+const HarnessTaskPlanStepSchemaDefinition = z.object({
+    /** CLI command path that runs the step's operation; the caller supplies required flags. */
+    cliCommand: z.string(),
+    /** MCP tool that runs the step's operation; null for CLI-only operations. Supply arguments matching the tool's schema. */
+    mcpTool: z.string().nullish(),
+    /** The stored step. */
+    step: HarnessTaskStepSchema,
+});
+/**
+ * One task step with the CLI command and MCP tool that run its operation.
+ *
+ * @openapiSchema HarnessTaskPlanStep
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanSchema
+ * @contractShape harness.task-plan-step
+ * @contractRole canonical
+ */
+export const HarnessTaskPlanStepSchema = HarnessTaskPlanStepSchemaDefinition;
+//# sourceMappingURL=task-plan-step.js.map

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

@@ -0,0 +1,43 @@
+import { z } from "zod/v4";
+/**
+ * One catalog task's typed inputs and ordered steps with derived CLI commands and MCP tools, read from the stated catalog revision.
+ *
+ * @openapiSchema HarnessTaskPlan
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpResolutionSchema
+ * @contractShape harness.task-plan
+ * @contractRole canonical
+ */
+export declare const HarnessTaskPlanSchema: z.ZodObject<{
+    catalogRevision: z.ZodInt;
+    input: z.ZodArray<z.ZodType<{
+        description: string;
+        key: string;
+        type: "ENTITY" | "TEXT";
+    }, unknown, z.core.$ZodTypeInternals<{
+        description: string;
+        key: string;
+        type: "ENTITY" | "TEXT";
+    }, unknown>>>;
+    step: z.ZodArray<z.ZodType<{
+        cliCommand: string;
+        mcpTool?: string | null | undefined;
+        step: {
+            instruction: string;
+            operationId: string;
+            stepKey: string;
+        };
+    }, unknown, z.core.$ZodTypeInternals<{
+        cliCommand: string;
+        mcpTool?: string | null | undefined;
+        step: {
+            instruction: string;
+            operationId: string;
+            stepKey: string;
+        };
+    }, unknown>>>;
+    taskKey: z.ZodString;
+}, z.core.$strip>;
+export type HarnessTaskPlan = z.infer<typeof HarnessTaskPlanSchema>;
+//# sourceMappingURL=task-plan.d.ts.map

package/dist/harness/task-plan.js

@@ -0,0 +1,25 @@
+// 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 { HarnessTaskPlanStepSchema } from "./task-plan-step.js";
+import { HarnessTaskSchema } from "./task.js";
+/**
+ * One catalog task's typed inputs and ordered steps with derived CLI commands and MCP tools, read from the stated catalog revision.
+ *
+ * @openapiSchema HarnessTaskPlan
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpResolutionSchema
+ * @contractShape harness.task-plan
+ * @contractRole canonical
+ */
+export const HarnessTaskPlanSchema = z.object({
+    /** Stored catalog revision this plan was read from. */
+    catalogRevision: z.int(),
+    /** Typed inputs the task needs before it runs. */
+    input: z.array(HarnessTaskSchema),
+    /** Steps in run order; an empty list means this catalog task is unplanned. */
+    step: z.array(HarnessTaskPlanStepSchema),
+    /** Agent-task catalog key. */
+    taskKey: z.string(),
+});
+//# sourceMappingURL=task-plan.js.map

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

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const HarnessTaskStepSchemaDefinition: z.ZodObject<{
+    instruction: z.ZodString;
+    operationId: z.ZodString;
+    stepKey: z.ZodString;
+}, z.core.$strip>;
+type HarnessTaskStepDefinition = z.infer<typeof HarnessTaskStepSchemaDefinition>;
+/**
+ * One ordered task step: its key, instruction, and the operation that runs it.
+ *
+ * @openapiSchema HarnessTaskStep
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanStepSchema
+ * @contractShape harness.task-step
+ * @contractRole canonical
+ */
+export declare const HarnessTaskStepSchema: z.ZodType<HarnessTaskStepDefinition>;
+export type HarnessTaskStep = z.infer<typeof HarnessTaskStepSchema>;
+export {};
+//# sourceMappingURL=task-step.d.ts.map

package/dist/harness/task-step.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 HarnessTaskStepSchemaDefinition = z.object({
+    /** What this step does, written for the agent that runs it. */
+    instruction: z.string(),
+    /** OpenAPI operationId this step calls; it must be in the task's operation list. */
+    operationId: z.string(),
+    /** Step key, unique within its task. */
+    stepKey: z.string(),
+});
+/**
+ * One ordered task step: its key, instruction, and the operation that runs it.
+ *
+ * @openapiSchema HarnessTaskStep
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanStepSchema
+ * @contractShape harness.task-step
+ * @contractRole canonical
+ */
+export const HarnessTaskStepSchema = HarnessTaskStepSchemaDefinition;
+//# sourceMappingURL=task-step.js.map

package/dist/harness/task.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+declare const HarnessTaskSchemaDefinition: z.ZodObject<{
+    description: z.ZodString;
+    key: z.ZodString;
+    type: z.ZodEnum<{
+        ENTITY: "ENTITY";
+        TEXT: "TEXT";
+    }>;
+}, z.core.$strip>;
+type HarnessTaskDefinition = z.infer<typeof HarnessTaskSchemaDefinition>;
+/**
+ * One typed task input that must be bound before a run starts.
+ *
+ * @openapiSchema HarnessTaskInput
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanSchema
+ * @contractShape harness.task
+ * @contractRole canonical
+ */
+export declare const HarnessTaskSchema: z.ZodType<HarnessTaskDefinition>;
+export type HarnessTask = z.infer<typeof HarnessTaskSchema>;
+export {};
+//# sourceMappingURL=task.d.ts.map

package/dist/harness/task.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 { HarnessTaskInputTypeSchema } from "./task-input-type.js";
+const HarnessTaskSchemaDefinition = z.object({
+    /** What the value is, written for the caller that supplies it. */
+    description: z.string(),
+    /** Input key, unique within its task. */
+    key: z.string(),
+    /** How the value is bound. */
+    type: HarnessTaskInputTypeSchema,
+});
+/**
+ * One typed task input that must be bound before a run starts.
+ *
+ * @openapiSchema HarnessTaskInput
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanSchema
+ * @contractShape harness.task
+ * @contractRole canonical
+ */
+export const HarnessTaskSchema = HarnessTaskSchemaDefinition;
+//# sourceMappingURL=task.js.map

package/dist/help/resolution.d.ts

@@ -30,6 +30,36 @@ export declare const HelpResolutionSchema: z.ZodObject<{
     }>;
     probability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     taskKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    taskPlan: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        catalogRevision: z.ZodInt;
+        input: z.ZodArray<z.ZodType<{
+            description: string;
+            key: string;
+            type: "ENTITY" | "TEXT";
+        }, unknown, z.core.$ZodTypeInternals<{
+            description: string;
+            key: string;
+            type: "ENTITY" | "TEXT";
+        }, unknown>>>;
+        step: z.ZodArray<z.ZodType<{
+            cliCommand: string;
+            mcpTool?: string | null | undefined;
+            step: {
+                instruction: string;
+                operationId: string;
+                stepKey: string;
+            };
+        }, unknown, z.core.$ZodTypeInternals<{
+            cliCommand: string;
+            mcpTool?: string | null | undefined;
+            step: {
+                instruction: string;
+                operationId: string;
+                stepKey: string;
+            };
+        }, unknown>>>;
+        taskKey: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type HelpResolution = z.infer<typeof HelpResolutionSchema>;
 //# sourceMappingURL=resolution.d.ts.map

package/dist/help/resolution.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 { HarnessTaskPlanSchema } from "../harness/task-plan.js";
 import { HelpCitationSchema } from "./citation.js";
 import { HelpResolutionOutcomeSchema } from "./resolution-outcome.js";
 /**
@@ -19,9 +20,11 @@ export const HelpResolutionSchema = z.object({
     operationId: z.string().nullish(),
     /** Which of the mutually exclusive resolve outcomes was reached. */
     outcome: HelpResolutionOutcomeSchema,
-    /** Probability the decision model gave the chosen option (an operation, or none). */
+    /** Probability the decision model gave its chosen option (an operation, a task, several, or none); informational, the choice alone decides the outcome. */
     probability: z.number().nullish(),
-    /** The chosen catalog task for TASK_PLAN, or the task leading a CLARIFY; getHarnessTaskPlan reads its plan. */
+    /** The chosen catalog task for TASK_PLAN, or the task leading a CLARIFY. */
     taskKey: z.string().nullish(),
+    /** The chosen task's plan for TASK_PLAN when the caller may read catalog task plans; absent otherwise. */
+    taskPlan: HarnessTaskPlanSchema.nullish(),
 });
 //# sourceMappingURL=resolution.js.map

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

@@ -18,6 +18,7 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         INFERENCE_PROVIDER_RESPONSE_EMPTY: "INFERENCE_PROVIDER_RESPONSE_EMPTY";
         JOBRUNR_DISABLED: "JOBRUNR_DISABLED";
         JOBRUNR_STORAGE_UNAVAILABLE: "JOBRUNR_STORAGE_UNAVAILABLE";
+        account_exists: "account_exists";
         billing_additional_usage_cap_reached: "billing_additional_usage_cap_reached";
         billing_allowance_exhausted: "billing_allowance_exhausted";
         callback_challenge_failed: "callback_challenge_failed";

package/dist/http/problem-detail.js

@@ -33,6 +33,8 @@ const ProblemDetailSchemaDefinition = z.object({
             "billing_allowance_exhausted",
             /** The caller's monthly allowance is spent and the next additional-usage unit would pass the monthly spend cap or the prepaid credit left. Agent action: stop and report ProblemDetail.allowanceType, limit, used, remaining, and resetAt; raise the cap or buy credit through /v1/billing/additional-usage, or wait for resetAt. */
             "billing_additional_usage_cap_reached",
+            /** A signed-out purchase named an email that already belongs to an account. Agent action: sign that account in with its email code, then subscribe signed in; never retry the signed-out purchase for that email. */
+            "account_exists",
             /** Detail-origin cold-miss coalescing is saturated. Agent action: treat as backend capacity impairment, back off, and inspect backend pool/bulkhead metrics; this is not a caller throttle. */
             "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. */

package/dist/link/search.d.ts

@@ -10,6 +10,16 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     sourceId: string;
                 }[];
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                paragraph: {
+                    citation: {
+                        entityId: string;
+                        source: "entityRecord" | "newsArticle" | "researchSnippet";
+                        sourceId: string;
+                    }[];
+                    text: string;
+                    topic?: string | null | undefined;
+                }[];
+                relatedQuery: string[];
                 text: string;
             } | null | undefined;
             interpretation: {
@@ -2087,6 +2097,20 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             totalElements: number;
             totalPages: number;
         };
+        newsEntityMention: {
+            entity: {
+                createdAt: string;
+                entityId: string;
+                href?: string | null | undefined;
+                internal: boolean;
+                matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+                mention?: string | null | undefined;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                updatedAt: string;
+            }[];
+            newsId: number;
+        }[];
         person: {
             interpretation: {
                 confidence: "HIGH" | "LOW" | "MEDIUM";
@@ -2233,6 +2257,16 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     sourceId: string;
                 }[];
                 confidence: "HIGH" | "LOW" | "MEDIUM";
+                paragraph: {
+                    citation: {
+                        entityId: string;
+                        source: "entityRecord" | "newsArticle" | "researchSnippet";
+                        sourceId: string;
+                    }[];
+                    text: string;
+                    topic?: string | null | undefined;
+                }[];
+                relatedQuery: string[];
                 text: string;
             } | null | undefined;
             interpretation: {
@@ -4310,6 +4344,20 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             totalElements: number;
             totalPages: number;
         };
+        newsEntityMention: {
+            entity: {
+                createdAt: string;
+                entityId: string;
+                href?: string | null | undefined;
+                internal: boolean;
+                matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+                mention?: string | null | undefined;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                updatedAt: string;
+            }[];
+            newsId: number;
+        }[];
         person: {
             interpretation: {
                 confidence: "HIGH" | "LOW" | "MEDIUM";

package/dist/natural/search-result.d.ts

@@ -15,6 +15,24 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             LOW: "LOW";
             MEDIUM: "MEDIUM";
         }>;
+        paragraph: z.ZodArray<z.ZodType<{
+            citation: {
+                entityId: string;
+                source: "entityRecord" | "newsArticle" | "researchSnippet";
+                sourceId: string;
+            }[];
+            text: string;
+            topic?: string | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            citation: {
+                entityId: string;
+                source: "entityRecord" | "newsArticle" | "researchSnippet";
+                sourceId: string;
+            }[];
+            text: string;
+            topic?: string | null | undefined;
+        }, unknown>>>;
+        relatedQuery: z.ZodArray<z.ZodString>;
         text: z.ZodString;
     }, z.core.$strip>>>;
     interpretation: z.ZodType<{

package/dist/news/entity-mention.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod/v4";
+declare const NewsEntityMentionSchemaDefinition: z.ZodObject<{
+    entity: z.ZodArray<z.ZodType<{
+        createdAt: string;
+        entityId: string;
+        href?: string | null | undefined;
+        internal: boolean;
+        matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+        mention?: string | null | undefined;
+        slug?: string | null | undefined;
+        typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+        updatedAt: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        createdAt: string;
+        entityId: string;
+        href?: string | null | undefined;
+        internal: boolean;
+        matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+        mention?: string | null | undefined;
+        slug?: string | null | undefined;
+        typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+        updatedAt: string;
+    }, unknown>>>;
+    newsId: z.ZodInt;
+}, z.core.$strip>;
+type NewsEntityMentionDefinition = z.infer<typeof NewsEntityMentionSchemaDefinition>;
+/**
+ * Public entities one news article links to, in link order.
+ *
+ * @openapiSchema NewsEntityMention
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @usedBySchema FederatedSearchSchema
+ * @contractShape news.entity-mention
+ * @contractRole canonical
+ */
+export declare const NewsEntityMentionSchema: z.ZodType<NewsEntityMentionDefinition>;
+export type NewsEntityMention = z.infer<typeof NewsEntityMentionSchema>;
+export {};
+//# sourceMappingURL=entity-mention.d.ts.map

package/dist/news/entity-mention.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";
+import { NewsResolvedEntityLinkSchema } from "./resolved-entity-link.js";
+const NewsEntityMentionSchemaDefinition = z.object({
+    /** Public entities the article links to. */
+    entity: z.array(NewsResolvedEntityLinkSchema),
+    /** News article id. */
+    newsId: z.int(),
+});
+/**
+ * Public entities one news article links to, in link order.
+ *
+ * @openapiSchema NewsEntityMention
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @usedBySchema FederatedSearchSchema
+ * @contractShape news.entity-mention
+ * @contractRole canonical
+ */
+export const NewsEntityMentionSchema = NewsEntityMentionSchemaDefinition;
+//# sourceMappingURL=entity-mention.js.map

package/dist/news/match-status.d.ts

@@ -4,7 +4,10 @@ import { z } from "zod/v4";
  *
  * @openapiSchema NewsMatchStatus
  * @endpoint GET /v1/news/lookup
+ * @endpoint GET /v1/search/link
  * @endpoint GET /v1/news/{newsId}
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
  * @usedBySchema NewsResolvedEntityLinkSchema
  * @usedBySchema NewsResolvedPersonLinkSchema
  * @contractShape news.match-status

package/dist/news/match-status.js

@@ -5,7 +5,10 @@ import { z } from "zod/v4";
  *
  * @openapiSchema NewsMatchStatus
  * @endpoint GET /v1/news/lookup
+ * @endpoint GET /v1/search/link
  * @endpoint GET /v1/news/{newsId}
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
  * @usedBySchema NewsResolvedEntityLinkSchema
  * @usedBySchema NewsResolvedPersonLinkSchema
  * @contractShape news.match-status

package/dist/news/resolved-entity-link.d.ts

@@ -31,8 +31,12 @@ type NewsResolvedEntityLinkDefinition = z.infer<typeof NewsResolvedEntityLinkSch
  *
  * @openapiSchema NewsResolvedEntityLink
  * @endpoint GET /v1/news/lookup
+ * @endpoint GET /v1/search/link
  * @endpoint GET /v1/news/{newsId}
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
  * @usedBySchema NewsDetailSchema
+ * @usedBySchema NewsEntityMentionSchema
  * @contractShape news.resolved-entity-link
  * @contractRole canonical
  */

package/dist/news/resolved-entity-link.js

@@ -24,8 +24,12 @@ const NewsResolvedEntityLinkSchemaDefinition = z.object({
  *
  * @openapiSchema NewsResolvedEntityLink
  * @endpoint GET /v1/news/lookup
+ * @endpoint GET /v1/search/link
  * @endpoint GET /v1/news/{newsId}
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
  * @usedBySchema NewsDetailSchema
+ * @usedBySchema NewsEntityMentionSchema
  * @contractShape news.resolved-entity-link
  * @contractRole canonical
  */

package/dist/openapi-component-manifest.js

@@ -486,6 +486,17 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     },
     HarnessRunStatus: { modulePath: "harness/run-status", schemaName: "HarnessRunStatusSchema" },
     HarnessRunType: { modulePath: "harness/run-type", schemaName: "HarnessRunTypeSchema" },
+    HarnessTaskInput: { modulePath: "harness/task", schemaName: "HarnessTaskSchema" },
+    HarnessTaskInputType: {
+        modulePath: "harness/task-input-type",
+        schemaName: "HarnessTaskInputTypeSchema",
+    },
+    HarnessTaskPlan: { modulePath: "harness/task-plan", schemaName: "HarnessTaskPlanSchema" },
+    HarnessTaskPlanStep: {
+        modulePath: "harness/task-plan-step",
+        schemaName: "HarnessTaskPlanStepSchema",
+    },
+    HarnessTaskStep: { modulePath: "harness/task-step", schemaName: "HarnessTaskStepSchema" },
     HelpCitation: { modulePath: "help/citation", schemaName: "HelpCitationSchema" },
     HelpResolution: { modulePath: "help/resolution", schemaName: "HelpResolutionSchema" },
     HelpResolutionOutcome: {
@@ -538,6 +549,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "NewsCandidateScoreSchema",
     },
     NewsDetail: { modulePath: "news/detail", schemaName: "NewsDetailSchema" },
+    NewsEntityMention: { modulePath: "news/entity-mention", schemaName: "NewsEntityMentionSchema" },
     NewsFeedback: { modulePath: "news/feedback", schemaName: "NewsFeedbackSchema" },
     NewsFeedbackAcknowledgement: {
         modulePath: "news/feedback-acknowledgement",
@@ -799,6 +811,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "search/answer-citation",
         schemaName: "SearchAnswerCitationSchema",
     },
+    SearchAnswerParagraph: {
+        modulePath: "search/answer-paragraph",
+        schemaName: "SearchAnswerParagraphSchema",
+    },
     SearchDuplicateCandidateScore: {
         modulePath: "search/duplicate-candidate-score",
         schemaName: "SearchDuplicateCandidateScoreSchema",

package/dist/search/answer-citation.d.ts

@@ -17,6 +17,7 @@ type SearchAnswerCitationDefinition = z.infer<typeof SearchAnswerCitationSchemaD
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerParagraphSchema
  * @usedBySchema SearchAnswerSchema
  * @contractShape search.answer-citation
  * @contractRole canonical

package/dist/search/answer-citation.js

@@ -17,6 +17,7 @@ const SearchAnswerCitationSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerParagraphSchema
  * @usedBySchema SearchAnswerSchema
  * @contractShape search.answer-citation
  * @contractRole canonical

package/dist/search/answer-paragraph.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod/v4";
+declare const SearchAnswerParagraphSchemaDefinition: z.ZodObject<{
+    citation: z.ZodArray<z.ZodType<{
+        entityId: string;
+        source: "entityRecord" | "newsArticle" | "researchSnippet";
+        sourceId: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        entityId: string;
+        source: "entityRecord" | "newsArticle" | "researchSnippet";
+        sourceId: string;
+    }, unknown>>>;
+    text: z.ZodString;
+    topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type SearchAnswerParagraphDefinition = z.infer<typeof SearchAnswerParagraphSchemaDefinition>;
+/**
+ * One paragraph of an answer and the evidence it rests on.
+ *
+ * @openapiSchema SearchAnswerParagraph
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerSchema
+ * @contractShape search.answer-paragraph
+ * @contractRole canonical
+ */
+export declare const SearchAnswerParagraphSchema: z.ZodType<SearchAnswerParagraphDefinition>;
+export type SearchAnswerParagraph = z.infer<typeof SearchAnswerParagraphSchema>;
+export {};
+//# sourceMappingURL=answer-paragraph.d.ts.map

package/dist/search/answer-paragraph.js

@@ -0,0 +1,25 @@
+// 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 { SearchAnswerCitationSchema } from "./answer-citation.js";
+const SearchAnswerParagraphSchemaDefinition = z.object({
+    /** Evidence this paragraph rests on, most important first. */
+    citation: z.array(SearchAnswerCitationSchema),
+    /** Paragraph text in plain prose. */
+    text: z.string(),
+    /** Short label naming the category, market, or segment this paragraph covers, such as "Smartphones · North America"; absent on the lead paragraph. */
+    topic: z.string().nullish(),
+});
+/**
+ * One paragraph of an answer and the evidence it rests on.
+ *
+ * @openapiSchema SearchAnswerParagraph
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @usedBySchema SearchAnswerSchema
+ * @contractShape search.answer-paragraph
+ * @contractRole canonical
+ */
+export const SearchAnswerParagraphSchema = SearchAnswerParagraphSchemaDefinition;
+//# sourceMappingURL=answer-paragraph.js.map

package/dist/search/answer.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no citation means the evidence does not answer the question.
+ * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no paragraph means the evidence does not answer the question.
  *
  * @openapiSchema SearchAnswer
  * @endpoint GET /v1/search/link
@@ -26,6 +26,24 @@ export declare const SearchAnswerSchema: z.ZodObject<{
         LOW: "LOW";
         MEDIUM: "MEDIUM";
     }>;
+    paragraph: z.ZodArray<z.ZodType<{
+        citation: {
+            entityId: string;
+            source: "entityRecord" | "newsArticle" | "researchSnippet";
+            sourceId: string;
+        }[];
+        text: string;
+        topic?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        citation: {
+            entityId: string;
+            source: "entityRecord" | "newsArticle" | "researchSnippet";
+            sourceId: string;
+        }[];
+        text: string;
+        topic?: string | null | undefined;
+    }, unknown>>>;
+    relatedQuery: z.ZodArray<z.ZodString>;
     text: z.ZodString;
 }, z.core.$strip>;
 export type SearchAnswer = z.infer<typeof SearchAnswerSchema>;

package/dist/search/answer.js

@@ -2,8 +2,9 @@
 import { z } from "zod/v4";
 import { ConfidenceSchema } from "../confidence/confidence.js";
 import { SearchAnswerCitationSchema } from "./answer-citation.js";
+import { SearchAnswerParagraphSchema } from "./answer-paragraph.js";
 /**
- * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no citation means the evidence does not answer the question.
+ * Written answer to a natural-language question, grounded only in the response's entity records and passages. LOW confidence with no paragraph means the evidence does not answer the question.
  *
  * @openapiSchema SearchAnswer
  * @endpoint GET /v1/search/link
@@ -15,11 +16,15 @@ import { SearchAnswerCitationSchema } from "./answer-citation.js";
  * @contractRole canonical
  */
 export const SearchAnswerSchema = z.object({
-    /** Evidence each claim rests on, in first-use order. */
+    /** Evidence the paragraphs cite, in first-use order. */
     citation: z.array(SearchAnswerCitationSchema),
     /** How fully the cited evidence answers the question. */
     confidence: ConfidenceSchema,
-    /** Answer text in plain prose. */
+    /** The answer's paragraphs in reading order, each citing the evidence it rests on; empty when the answer abstains. A first paragraph without `topic` is the lead, written as a standalone answer of one or two sentences that reads complete when shown alone; later paragraphs expand it by topic without restating it. */
+    paragraph: z.array(SearchAnswerParagraphSchema),
+    /** Up to five follow-up searches grounded in the cited evidence; empty when the answer abstains. */
+    relatedQuery: z.array(z.string()),
+    /** Every paragraph's text in reading order, separated by blank lines; read `paragraph` to place each citation beside the text it supports. */
     text: z.string(),
 });
 //# sourceMappingURL=answer.js.map

package/dist/search/layer.d.ts

@@ -1,8 +1,9 @@
 import { z } from "zod/v4";
 /**
- * Optional answer layer for a natural-language entity search. `passage` adds the text passages, from public research snippets and linked news, that best answer the question about the subject entities, their peers, or the top results; `synthesis` adds a written answer grounded only in those records and passages, citing each, and implies `passage`. `judgment` ranks the answer to a competitor, market, or provider question ("who competes with X", "top X companies", "who provides X") by the judged probability that each entity answers it; `web` adds web search evidence, and the companies those results name, before judging and implies `judgment`. Other questions ignore `judgment` and `web`.
+ * Optional answer layer for a natural-language entity search. `passage` adds the text passages, from public research snippets and linked news, that best answer the question about the subject entities, their peers, or the top results; `synthesis` adds a written answer grounded only in those records and passages, citing each, and implies `passage`. A competitor, market, or provider question ("who competes with X", "top X companies", "who provides X") is always ranked by the judged probability that each entity answers it, so `judgment` adds nothing beyond that; `web` adds web search evidence, and the companies those results name, before judging. Other questions ignore `judgment` and `web`.
  *
  * @openapiSchema SearchLayer
+ * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @contractShape search.layer
  * @contractRole canonical

package/dist/search/layer.js

@@ -1,9 +1,10 @@
 // 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";
 /**
- * Optional answer layer for a natural-language entity search. `passage` adds the text passages, from public research snippets and linked news, that best answer the question about the subject entities, their peers, or the top results; `synthesis` adds a written answer grounded only in those records and passages, citing each, and implies `passage`. `judgment` ranks the answer to a competitor, market, or provider question ("who competes with X", "top X companies", "who provides X") by the judged probability that each entity answers it; `web` adds web search evidence, and the companies those results name, before judging and implies `judgment`. Other questions ignore `judgment` and `web`.
+ * Optional answer layer for a natural-language entity search. `passage` adds the text passages, from public research snippets and linked news, that best answer the question about the subject entities, their peers, or the top results; `synthesis` adds a written answer grounded only in those records and passages, citing each, and implies `passage`. A competitor, market, or provider question ("who competes with X", "top X companies", "who provides X") is always ranked by the judged probability that each entity answers it, so `judgment` adds nothing beyond that; `web` adds web search evidence, and the companies those results name, before judging. Other questions ignore `judgment` and `web`.
  *
  * @openapiSchema SearchLayer
+ * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @contractShape search.layer
  * @contractRole canonical

package/dist/search/mode.d.ts

@@ -9,7 +9,7 @@ declare const SearchModeSchemaDefinition: z.ZodUnion<readonly [z.ZodEnum<{
 }>, z.ZodString]>;
 type SearchModeDefinition = z.infer<typeof SearchModeSchemaDefinition>;
 /**
- * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused).
+ * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused; each ranking is cut at the largest page size, so a hybrid search returns at most twice that many items, and it orders by fused rank only, ignoring `sort`).
  *
  * @openapiSchema SearchMode
  * @endpoint GET /v1/search/link

package/dist/search/mode.js

@@ -5,7 +5,7 @@ const SearchModeSchemaDefinition = z.union([
     z.string(),
 ]);
 /**
- * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused).
+ * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner; `hybrid` fuses keyword and semantic rankings by reciprocal rank. Entity and person natural-search support every mode but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies), and `hybrid` (that owner's keyword and semantic rankings fused; each ranking is cut at the largest page size, so a hybrid search returns at most twice that many items, and it orders by fused rank only, ignoring `sort`).
  *
  * @openapiSchema SearchMode
  * @endpoint GET /v1/search/link

package/package.json

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