@aventurevc/api-schemas 0.8.114 → 0.8.125

package/dist/harness/task-write-guidance.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+/**
+ * The expectation, body, type hints, rejections, override, and method for one judged prose write.
+ *
+ * @openapiSchema HarnessTaskWriteGuidance
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanStepSchema
+ * @contractShape harness.task-write-guidance
+ * @contractRole canonical
+ */
+export declare const HarnessTaskWriteGuidanceSchema: z.ZodObject<{
+    body: z.ZodString;
+    expectation: z.ZodString;
+    method: z.ZodArray<z.ZodString>;
+    override: z.ZodString;
+    reject: z.ZodArray<z.ZodString>;
+    typeCatalog: z.ZodString;
+}, z.core.$strip>;
+export type HarnessTaskWriteGuidance = z.infer<typeof HarnessTaskWriteGuidanceSchema>;
+//# sourceMappingURL=task-write-guidance.d.ts.map

package/dist/harness/task-write-guidance.js

@@ -0,0 +1,27 @@
+// 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";
+/**
+ * The expectation, body, type hints, rejections, override, and method for one judged prose write.
+ *
+ * @openapiSchema HarnessTaskWriteGuidance
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanStepSchema
+ * @contractShape harness.task-write-guidance
+ * @contractRole canonical
+ */
+export const HarnessTaskWriteGuidanceSchema = z.object({
+    /** The request body keys, the key that carries the prose, and a minimal JSON example. */
+    body: z.string(),
+    /** The one sentence the prose aims for. */
+    expectation: z.string(),
+    /** Help sections that teach this prose, each with the command that retrieves it. */
+    method: z.array(z.string()),
+    /** The override field, the problems it may waive, and its terms. */
+    override: z.string(),
+    /** Each problem that rejects this prose: what fails it and the fix. */
+    reject: z.array(z.string()),
+    /** The read that serves this write's per-type hints; read it before writing. */
+    typeCatalog: z.string(),
+});
+//# sourceMappingURL=task-write-guidance.js.map

package/dist/help/citation.d.ts

@@ -2,13 +2,15 @@ import { z } from "zod/v4";
 declare const HelpCitationSchemaDefinition: z.ZodObject<{
     excerpt: z.ZodString;
     sourceId: z.ZodString;
-    sourceType: z.ZodEnum<{
+    sourceType: z.ZodUnion<readonly [z.ZodEnum<{
         COMPLETION_GATE: "COMPLETION_GATE";
         OPERATION: "OPERATION";
         PROMPT: "PROMPT";
         RESEARCH_DETAIL_TYPE: "RESEARCH_DETAIL_TYPE";
+        RESEARCH_SNIPPET_TYPE: "RESEARCH_SNIPPET_TYPE";
         SKILL: "SKILL";
-    }>;
+        TEXT_TYPE: "TEXT_TYPE";
+    }>, z.ZodString]>;
     sourceVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type HelpCitationDefinition = z.infer<typeof HelpCitationSchemaDefinition>;

package/dist/help/resolution.d.ts

@@ -13,12 +13,12 @@ export declare const HelpResolutionSchema: z.ZodObject<{
     candidate: z.ZodArray<z.ZodType<{
         excerpt: string;
         sourceId: string;
-        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceType: string;
         sourceVersion?: string | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
         excerpt: string;
         sourceId: string;
-        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceType: string;
         sourceVersion?: string | null | undefined;
     }, unknown>>>;
     operationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -50,6 +50,14 @@ export declare const HelpResolutionSchema: z.ZodObject<{
                 operationId: string;
                 stepKey: string;
             };
+            writeGuidance?: {
+                body: string;
+                expectation: string;
+                method: string[];
+                override: string;
+                reject: string[];
+                typeCatalog: string;
+            } | null | undefined;
         }, unknown, z.core.$ZodTypeInternals<{
             cliCommand: string;
             mcpTool?: string | null | undefined;
@@ -58,6 +66,14 @@ export declare const HelpResolutionSchema: z.ZodObject<{
                 operationId: string;
                 stepKey: string;
             };
+            writeGuidance?: {
+                body: string;
+                expectation: string;
+                method: string[];
+                override: string;
+                reject: string[];
+                typeCatalog: string;
+            } | null | undefined;
         }, unknown>>>;
         taskKey: z.ZodString;
     }, z.core.$strip>>>;

package/dist/help/source-type.d.ts

@@ -9,12 +9,14 @@ import { z } from "zod/v4";
  * @contractShape help.source-type
  * @contractRole canonical
  */
-export declare const HelpSourceTypeSchema: z.ZodEnum<{
+export declare const HelpSourceTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     COMPLETION_GATE: "COMPLETION_GATE";
     OPERATION: "OPERATION";
     PROMPT: "PROMPT";
     RESEARCH_DETAIL_TYPE: "RESEARCH_DETAIL_TYPE";
+    RESEARCH_SNIPPET_TYPE: "RESEARCH_SNIPPET_TYPE";
     SKILL: "SKILL";
-}>;
+    TEXT_TYPE: "TEXT_TYPE";
+}>, z.ZodString]>;
 export type HelpSourceType = z.infer<typeof HelpSourceTypeSchema>;
 //# sourceMappingURL=source-type.d.ts.map

package/dist/help/source-type.js

@@ -10,11 +10,16 @@ import { z } from "zod/v4";
  * @contractShape help.source-type
  * @contractRole canonical
  */
-export const HelpSourceTypeSchema = z.enum([
-    "OPERATION",
-    "SKILL",
-    "PROMPT",
-    "COMPLETION_GATE",
-    "RESEARCH_DETAIL_TYPE",
+export const HelpSourceTypeSchema = z.union([
+    z.enum([
+        "OPERATION",
+        "SKILL",
+        "PROMPT",
+        "COMPLETION_GATE",
+        "RESEARCH_DETAIL_TYPE",
+        "RESEARCH_SNIPPET_TYPE",
+        "TEXT_TYPE",
+    ]),
+    z.string(),
 ]);
 //# sourceMappingURL=source-type.js.map

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

@@ -55,6 +55,7 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         origin_detail_capacity: "origin_detail_capacity";
         origin_detail_shutdown: "origin_detail_shutdown";
         primary_website_missing: "primary_website_missing";
+        prose_rejected: "prose_rejected";
         r2_delete_failed: "r2_delete_failed";
         r2_fetch_failed: "r2_fetch_failed";
         r2_upload_failed: "r2_upload_failed";
@@ -243,6 +244,17 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
     parseError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("./json-value.ts").JsonValue, unknown, z.core.$ZodTypeInternals<import("./json-value.ts").JsonValue, unknown>>>>;
+    proseViolation: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        overridable: boolean;
+        passage: string;
+        problem: string;
+        reason: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        overridable: boolean;
+        passage: string;
+        problem: string;
+        reason: string;
+    }, unknown>>>>>;
     remaining: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     requiredRole: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     resetAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;

package/dist/http/problem-detail.js

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
 import { DomainConflictDetailsSchema } from "../domain/conflict-details.js";
 import { JsonValueSchema } from "./json-value.js";
 import { ProblemResolutionSchema } from "../problem/resolution.js";
+import { ProseViolationSchema } from "../prose/violation.js";
 import { CurrentSlugOwnerSchema } from "../redirect/current-slug-owner.js";
 import { RedirectSlugPathSchema } from "../redirect/redirect-slug-path.js";
 const ProblemDetailSchemaDefinition = z.object({
@@ -43,6 +44,8 @@ const ProblemDetailSchemaDefinition = z.object({
             "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. */
             "suspected_shell_strip",
+            /** Entity text or a research snippet was rejected by its prose judge or text contract. Agent action: rewrite every passage in ProblemDetail.proseViolation at once and resend the whole text; ProblemDetail.hint names the override only when every violation is overridable. */
+            "prose_rejected",
             /** A URL was submitted to the wrong write surface. Agent action: move the URL to the specific surface named by ProblemDetail.hint/resolution, for example EntityUrl.urlType=ycombinator via entities urls create instead of News.newsUrlOriginal. */
             "url_surface_misclassification",
             /** JobRunr background worker is disabled in this environment. Agent action: stop (this is an admin/ops configuration condition, not a retriable user error). */
@@ -190,6 +193,8 @@ const ProblemDetailSchemaDefinition = z.object({
     parseError: z.string().nullish(),
     path: z.string().nullish(),
     properties: z.record(z.string(), JsonValueSchema).optional(),
+    /** Every rejected passage of a PROSE_REJECTED write, once per problem it shows; absent for every other problem. */
+    proseViolation: z.array(ProseViolationSchema).nullish(),
     /** Cap minus used for the limitType meter, never negative. */
     remaining: z.number().int().nullish(),
     requiredRole: z.string().nullish(),

package/dist/link/search.d.ts

@@ -11,6 +11,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 }[];
                 confidence: "HIGH" | "LOW" | "MEDIUM";
                 description?: string | null | undefined;
+                heading?: string | null | undefined;
                 paragraph: {
                     citation: {
                         entityId: string;
@@ -148,7 +149,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 sort: {
                     order: {
                         descending: boolean;
-                        field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+                        field: string;
                         sortKey?: string | null | undefined;
                     }[];
                     relevance?: "keyword" | "semantic" | null | undefined;
@@ -620,6 +621,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                             totalRaisedUsd?: number | null | undefined;
                             unconvertedRoundCount: number;
                         } | null | undefined;
+                        headquartersAddressId?: number | null | undefined;
                         text: {
                             expanded?: string | null | undefined;
                             generatedDescription?: string | null | undefined;
@@ -1113,6 +1115,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                             totalRaisedUsd?: number | null | undefined;
                             unconvertedRoundCount: number;
                         } | null | undefined;
+                        headquartersAddressId?: number | null | undefined;
                         text: {
                             expanded?: string | null | undefined;
                             generatedDescription?: string | null | undefined;
@@ -1597,6 +1600,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                         totalRaisedUsd?: number | null | undefined;
                         unconvertedRoundCount: number;
                     } | null | undefined;
+                    headquartersAddressId?: number | null | undefined;
                     text: {
                         expanded?: string | null | undefined;
                         generatedDescription?: string | null | undefined;
@@ -2076,6 +2080,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -3455,6 +3460,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 }[];
                 confidence: "HIGH" | "LOW" | "MEDIUM";
                 description?: string | null | undefined;
+                heading?: string | null | undefined;
                 paragraph: {
                     citation: {
                         entityId: string;
@@ -3592,7 +3598,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                 sort: {
                     order: {
                         descending: boolean;
-                        field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+                        field: string;
                         sortKey?: string | null | undefined;
                     }[];
                     relevance?: "keyword" | "semantic" | null | undefined;
@@ -4064,6 +4070,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                             totalRaisedUsd?: number | null | undefined;
                             unconvertedRoundCount: number;
                         } | null | undefined;
+                        headquartersAddressId?: number | null | undefined;
                         text: {
                             expanded?: string | null | undefined;
                             generatedDescription?: string | null | undefined;
@@ -4557,6 +4564,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                             totalRaisedUsd?: number | null | undefined;
                             unconvertedRoundCount: number;
                         } | null | undefined;
+                        headquartersAddressId?: number | null | undefined;
                         text: {
                             expanded?: string | null | undefined;
                             generatedDescription?: string | null | undefined;
@@ -5041,6 +5049,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                         totalRaisedUsd?: number | null | undefined;
                         unconvertedRoundCount: number;
                     } | null | undefined;
+                    headquartersAddressId?: number | null | undefined;
                     text: {
                         expanded?: string | null | undefined;
                         generatedDescription?: string | null | undefined;
@@ -5520,6 +5529,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;

package/dist/lookup/job-mention.d.ts

@@ -291,6 +291,7 @@ declare const LookupJobMentionSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -768,6 +769,7 @@ declare const LookupJobMentionSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;

package/dist/lookup/job-mutation.d.ts

@@ -11,6 +11,7 @@ declare const LookupJobMutationSchemaDefinition: z.ZodObject<{
         searchQuery?: string | undefined;
         type: "COMPANY" | "PERSON" | "PRODUCT_SERVICE";
     }, unknown>>>>;
+    sourceDocumentId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     subject: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -40,7 +41,7 @@ declare const LookupJobMutationSchemaDefinition: z.ZodObject<{
 }, z.core.$strip>;
 type LookupJobMutationDefinition = z.infer<typeof LookupJobMutationSchemaDefinition>;
 /**
- * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; lookup-only bulk jobs and POST /v1/lookup-mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.
+ * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup-mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup-mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.
  *
  * @openapiSchema LookupJobMutation
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/lookup/job-mutation.js

@@ -5,6 +5,8 @@ import { LookupMentionSchema } from "./mention.js";
 const LookupJobMutationSchemaDefinition = z.object({
     /** Companies and people the caller already read, identified without sending the page or screenshot. Send them alone, without an article or file. On lookup jobs, maxNames is required and no shell records or enrichment are scheduled. */
     mention: z.array(LookupMentionSchema).optional(),
+    /** Id of a recorded source document whose text is the article, such as an email recorded with POST /v1/research/source-documents; send it alone. Only POST /v1/lookup-mentions reads it, for the admin key or RBAC EDIT_CACHE. */
+    sourceDocumentId: z.uuid().nullish(),
     /** aVenture news id of the article; an id that names no stored article is an error. */
     sourceNewsId: z.int().nullish(),
     /** URL of the article; read from aVenture news when stored there, otherwise fetched. */
@@ -13,7 +15,7 @@ const LookupJobMutationSchemaDefinition = z.object({
     subject: IdentificationSubjectSchema.nullish(),
 });
 /**
- * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; lookup-only bulk jobs and POST /v1/lookup-mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.
+ * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup-mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup-mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.
  *
  * @openapiSchema LookupJobMutation
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/lookup/job.d.ts

@@ -491,6 +491,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -1132,6 +1133,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -1491,6 +1493,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             searchQuery?: string | undefined;
             type: "COMPANY" | "PERSON" | "PRODUCT_SERVICE";
         }[] | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceNewsId?: number | null | undefined;
         sourceUrl?: string | null | undefined;
         subject?: {
@@ -1511,6 +1514,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             searchQuery?: string | undefined;
             type: "COMPANY" | "PERSON" | "PRODUCT_SERVICE";
         }[] | undefined;
+        sourceDocumentId?: string | null | undefined;
         sourceNewsId?: number | null | undefined;
         sourceUrl?: string | null | undefined;
         subject?: {

package/dist/mention/lookup.d.ts

@@ -292,6 +292,7 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -933,6 +934,7 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;

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

@@ -16,6 +16,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             MEDIUM: "MEDIUM";
         }>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         paragraph: z.ZodArray<z.ZodType<{
             citation: {
                 entityId: string;
@@ -161,7 +162,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
         sort: {
             order: {
                 descending: boolean;
-                field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+                field: string;
                 sortKey?: string | null | undefined;
             }[];
             relevance?: "keyword" | "semantic" | null | undefined;
@@ -291,7 +292,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
         sort: {
             order: {
                 descending: boolean;
-                field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+                field: string;
                 sortKey?: string | null | undefined;
             }[];
             relevance?: "keyword" | "semantic" | null | undefined;
@@ -933,6 +934,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -1424,6 +1426,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -1917,6 +1920,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -2400,6 +2404,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -2884,6 +2889,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -3361,6 +3367,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;

package/dist/natural/search.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod/v4";
 declare const NaturalSearchSchemaDefinition: z.ZodObject<{
+    answerModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cacheMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
         bypass: "bypass";
         refresh: "refresh";

package/dist/natural/search.js

@@ -4,7 +4,9 @@ import { ReasoningEffortSchema } from "../reasoning/effort.js";
 import { SearchCacheModeSchema } from "../search/cache-mode.js";
 import { SearchModeSchema } from "../search/mode.js";
 const NaturalSearchSchemaDefinition = z.object({
-    /** Search-stage cache policy. use reuses cached search work; bypass computes fresh without retaining outputs; refresh computes fresh and replaces normal entries. Record and immutable query-vector caches retain their own policy. */
+    /** Optional chat model for the synthesis answer; null uses the catalog's search answer model. The same allowlist as `model` applies. The answer writes the page heading, title, and description, so this compares answer models without changing the catalog. */
+    answerModel: z.string().nullish(),
+    /** Search-stage cache policy. use reuses cached search work; bypass computes fresh without retaining outputs; refresh computes fresh and replaces normal entries. Record and immutable query-vector caches retain their own policy. Callers without private-data access always run use. */
     cacheMode: SearchCacheModeSchema.default("use").optional(),
     /** Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). */
     mode: SearchModeSchema.default("auto").optional(),

package/dist/openapi-component-manifest.js

@@ -185,6 +185,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "cursor/slice-shared-search-list",
         schemaName: "CursorSliceSharedSearchListSchema",
     },
+    DatasourceDataSourceType: {
+        modulePath: "datasource/data-source-type",
+        schemaName: "DatasourceDataSourceTypeSchema",
+    },
     DatasourceProvenanceActorType: {
         modulePath: "datasource/provenance-actor-type",
         schemaName: "DatasourceProvenanceActorTypeSchema",
@@ -303,6 +307,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "entity/filter-search-result",
         schemaName: "EntityFilterSearchResultSchema",
     },
+    EntityFilterSortable: {
+        modulePath: "entity/filter-sortable",
+        schemaName: "EntityFilterSortableSchema",
+    },
     EntityFilterUiMeta: {
         modulePath: "entity/filter-ui-meta",
         schemaName: "EntityFilterUiMetaSchema",
@@ -518,6 +526,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "HarnessTaskPlanStepSchema",
     },
     HarnessTaskStep: { modulePath: "harness/task-step", schemaName: "HarnessTaskStepSchema" },
+    HarnessTaskWriteGuidance: {
+        modulePath: "harness/task-write-guidance",
+        schemaName: "HarnessTaskWriteGuidanceSchema",
+    },
     HelpCitation: { modulePath: "help/citation", schemaName: "HelpCitationSchema" },
     HelpResolution: { modulePath: "help/resolution", schemaName: "HelpResolutionSchema" },
     HelpResolutionOutcome: {
@@ -775,6 +787,8 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     ProblemDetail: { modulePath: "http/problem-detail", schemaName: "ProblemDetailSchema" },
     ProblemResolution: { modulePath: "problem/resolution", schemaName: "ProblemResolutionSchema" },
     ProblemType: { modulePath: "problem/type", schemaName: "ProblemTypeSchema" },
+    ProseProblem: { modulePath: "prose/problem", schemaName: "ProseProblemSchema" },
+    ProseViolation: { modulePath: "prose/violation", schemaName: "ProseViolationSchema" },
     Publication: { modulePath: "publication/publication", schemaName: "PublicationSchema" },
     PublicationFacet: { modulePath: "publication/facet", schemaName: "PublicationFacetSchema" },
     PublicationRelation: {
@@ -902,6 +916,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "strict/url-lookup-conflict",
         schemaName: "StrictUrlLookupConflictSchema",
     },
+    SuppressionReason: { modulePath: "suppression/reason", schemaName: "SuppressionReasonSchema" },
     SystemBuild: { modulePath: "system/system-build", schemaName: "SystemBuildSchema" },
     SystemBuildDetail: {
         modulePath: "system/system-build-detail",

package/dist/pagination/schemas.d.ts

@@ -870,6 +870,7 @@ declare const PageEntityDetailSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -1151,6 +1152,7 @@ declare const PageEntityDetailSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -2958,6 +2960,7 @@ declare const PageEntityInvestorParticipationSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -3889,6 +3892,7 @@ declare const PageEntityInvestorParticipationSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -4857,6 +4861,7 @@ declare const PageEntityListSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -5334,6 +5339,7 @@ declare const PageEntityListSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -6392,6 +6398,7 @@ declare const PageEntitySimilarityResultSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -6883,6 +6890,7 @@ declare const PageEntitySimilarityResultSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -10169,6 +10177,7 @@ declare const PageResultEntityListSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -10646,6 +10655,7 @@ declare const PageResultEntityListSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;