@aventurevc/api-schemas 0.8.114 → 0.8.125

package/dist/address/address.js

@@ -61,11 +61,11 @@ export const AddressSchema = z.object({
     createdAt: z.iso.datetime({ offset: true }).nullish(),
     /** Single-line formatted address */
     fullAddress: z.string().nullish(),
-    /** Address record identifier */
+    /** Id of this listed row's first association; PATCH and DELETE address one association by its association[].id, so a row holding several roles needs one call each */
     id: z.int().nullish(),
     /** Deprecated aggregate compatibility flag; true when any association is current */
     isCurrent: z.boolean().nullish(),
-    /** Deprecated legacy flag marking the headquarters or legal/registered address */
+    /** Deprecated legacy flag marking the current legal/registered seat (domicile), not the operating headquarters; read EntityEnrichment.headquartersAddressId for the headquarters */
     isHq: z.boolean().nullish(),
     /** Deprecated legacy flag marking the primary display address */
     isPrimary: z.boolean().nullish(),

package/dist/address/association-role.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Meaning of an entity or person address association. Domicile is a legal or registered seat and is not evidence of operational presence; dominant is the predominant display location; origin is the founding or historical location.
+ * Meaning of an entity or person address association. Dominant is the operating headquarters; domicile is the legal or registered seat and is not evidence of operational presence; origin is the founding or historical location.
  *
  * @openapiSchema AddressAssociationRole
  * @endpoint GET /v1/entities

package/dist/address/association-role.js

@@ -1,7 +1,7 @@
 // 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";
 /**
- * Meaning of an entity or person address association. Domicile is a legal or registered seat and is not evidence of operational presence; dominant is the predominant display location; origin is the founding or historical location.
+ * Meaning of an entity or person address association. Dominant is the operating headquarters; domicile is the legal or registered seat and is not evidence of operational presence; origin is the founding or historical location.
  *
  * @openapiSchema AddressAssociationRole
  * @endpoint GET /v1/entities

package/dist/agent/help.d.ts

@@ -4,12 +4,12 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
     citation: 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>>>;
     confidence: z.ZodEnum<{
@@ -21,12 +21,12 @@ declare const AgentHelpSchemaDefinition: 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>>;
@@ -58,6 +58,14 @@ declare const AgentHelpSchemaDefinition: 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;
@@ -66,6 +74,14 @@ declare const AgentHelpSchemaDefinition: 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/datasource/data-source-type.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+/**
+ * Full read/storage source type for field-level provenance rows. Write query parameters use DatasourceWritableDataSourceType.
+ *
+ * @openapiSchema DatasourceDataSourceType
+ * @endpoint GET /v1/entities
+ * @contractShape datasource.data-source-type
+ * @contractRole canonical
+ */
+export declare const DatasourceDataSourceTypeSchema: z.ZodEnum<{
+    api: "api";
+    aventureStaff: "aventureStaff";
+    blogArticle: "blogArticle";
+    firstPartyWebsite: "firstPartyWebsite";
+    import: "import";
+    llm: "llm";
+    manual: "manual";
+    newsArticle: "newsArticle";
+    relatedPartyWebsite: "relatedPartyWebsite";
+    requestChangeForm: "requestChangeForm";
+    thirdPartyWebsite: "thirdPartyWebsite";
+}>;
+export type DatasourceDataSourceType = z.infer<typeof DatasourceDataSourceTypeSchema>;
+//# sourceMappingURL=data-source-type.d.ts.map

package/dist/datasource/data-source-type.js

@@ -0,0 +1,24 @@
+// 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";
+/**
+ * Full read/storage source type for field-level provenance rows. Write query parameters use DatasourceWritableDataSourceType.
+ *
+ * @openapiSchema DatasourceDataSourceType
+ * @endpoint GET /v1/entities
+ * @contractShape datasource.data-source-type
+ * @contractRole canonical
+ */
+export const DatasourceDataSourceTypeSchema = z.enum([
+    "requestChangeForm",
+    "newsArticle",
+    "blogArticle",
+    "firstPartyWebsite",
+    "relatedPartyWebsite",
+    "thirdPartyWebsite",
+    "llm",
+    "aventureStaff",
+    "api",
+    "manual",
+    "import",
+]);
+//# sourceMappingURL=data-source-type.js.map

package/dist/entity/detail.d.ts

@@ -330,6 +330,7 @@ export declare const EntityDetailSchema: z.ZodObject<{
             totalRaisedUsd?: number | null | undefined;
             unconvertedRoundCount: number;
         } | null | undefined;
+        headquartersAddressId?: number | null | undefined;
         text: {
             expanded?: string | null | undefined;
             generatedDescription?: string | null | undefined;
@@ -611,6 +612,7 @@ export declare const EntityDetailSchema: 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/entity/enrichment.d.ts

@@ -501,6 +501,7 @@ declare const EntityEnrichmentSchemaDefinition: z.ZodObject<{
         totalRaisedUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         unconvertedRoundCount: z.ZodInt;
     }, z.core.$strip>>>;
+    headquartersAddressId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     text: z.ZodType<{
         expanded?: string | null | undefined;
         generatedDescription?: string | null | undefined;

package/dist/entity/enrichment.js

@@ -10,6 +10,8 @@ const EntityEnrichmentSchemaDefinition = z.object({
     /** Entity classification join projection for this read surface. Single-detail and full-detail batch reads include full history; list, default batch, and similar-entity reads may filter to current joins. Use GET /v1/entities/{entityId}/classifications?includeInactive=true for authoritative join history. */
     classification: EntityClassificationSchema,
     fundingDetail: EntityFundingDetailSchema.nullish(),
+    /** Address id of the current headquarters: the current dominant (operating) address; absent when none is on record, even when a domicile (legal seat) exists. Read this instead of the deprecated isHq flag, which marks the legal seat. */
+    headquartersAddressId: z.int().nullish(),
     text: EntityTextBundleSchema,
     /** URL link filter values */
     urlLink: z.array(EntityUrlLinkSchema),

package/dist/entity/filter-sortable.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod/v4";
+/**
+ * Entity filter sortable
+ *
+ * @openapiSchema EntityFilterSortable
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SortOrderEntityFilterSortableSchema
+ * @contractShape entity.filter-sortable
+ * @contractRole canonical
+ */
+export declare const EntityFilterSortableSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    ACCELERATOR_BRAND: "ACCELERATOR_BRAND";
+    ACCELERATOR_COHORT: "ACCELERATOR_COHORT";
+    AMOUNT_INVESTED: "AMOUNT_INVESTED";
+    CREATED_AT: "CREATED_AT";
+    DATA_COMPLETION_COVERAGE: "DATA_COMPLETION_COVERAGE";
+    EMPLOYEE_COUNT: "EMPLOYEE_COUNT";
+    HEADQUARTERS_COUNTRY: "HEADQUARTERS_COUNTRY";
+    ID: "ID";
+    LATEST_VALUATION: "LATEST_VALUATION";
+    MOST_RECENT_AMOUNT: "MOST_RECENT_AMOUNT";
+    MOST_RECENT_DATE: "MOST_RECENT_DATE";
+    NAME_BRAND: "NAME_BRAND";
+    NEXT_DUE_AT: "NEXT_DUE_AT";
+    RECENT_INVESTMENT_AT: "RECENT_INVESTMENT_AT";
+    STAGE: "STAGE";
+    STATUS_OPERATING: "STATUS_OPERATING";
+    TOTAL_RAISED: "TOTAL_RAISED";
+    UPDATED_AT: "UPDATED_AT";
+    YEAR_FOUNDED: "YEAR_FOUNDED";
+}>, z.ZodString]>;
+export type EntityFilterSortable = z.infer<typeof EntityFilterSortableSchema>;
+//# sourceMappingURL=filter-sortable.d.ts.map

package/dist/entity/filter-sortable.js

@@ -0,0 +1,42 @@
+// 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 filter sortable
+ *
+ * @openapiSchema EntityFilterSortable
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SortOrderEntityFilterSortableSchema
+ * @contractShape entity.filter-sortable
+ * @contractRole canonical
+ */
+export const EntityFilterSortableSchema = z.union([
+    z.enum([
+        "ID",
+        "NAME_BRAND",
+        "YEAR_FOUNDED",
+        "STATUS_OPERATING",
+        "UPDATED_AT",
+        "CREATED_AT",
+        "NEXT_DUE_AT",
+        "DATA_COMPLETION_COVERAGE",
+        "TOTAL_RAISED",
+        "AMOUNT_INVESTED",
+        "RECENT_INVESTMENT_AT",
+        "STAGE",
+        "MOST_RECENT_AMOUNT",
+        "LATEST_VALUATION",
+        "MOST_RECENT_DATE",
+        "ACCELERATOR_BRAND",
+        "ACCELERATOR_COHORT",
+        "HEADQUARTERS_COUNTRY",
+        "EMPLOYEE_COUNT",
+    ]),
+    z.string(),
+]);
+//# sourceMappingURL=filter-sortable.js.map

package/dist/entity/filter.js

@@ -83,7 +83,7 @@ export const EntityFilterSchema = z.strictObject({
     portfolioHeadquartersCountry: z.array(z.string()).optional(),
     /** Portfolio-company headquarters state or region values. */
     portfolioHeadquartersState: z.array(z.string()).optional(),
-    /** Named server-owned list quality gate. */
+    /** Server-owned list quality gate. */
     qualityGate: EntityListQualityGateSchema.optional(),
     /** Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean. */
     rankByProminence: z.boolean().nullish(),
@@ -100,7 +100,7 @@ export const EntityFilterSchema = z.strictObject({
     suppressLateStage: z.boolean().nullish(),
     /** Suppress entities with terminal operating status. */
     suppressNonOperating: z.boolean().nullish(),
-    /** Suppress entities whose USD-converted total raised is zero or unknown. */
+    /** Suppress entities with zero or unknown USD total raised. */
     suppressZeroTotalRaised: z.boolean().nullish(),
     /** General classification tag values. */
     tag: z.array(z.string()).optional(),

package/dist/entity/investor-participation.d.ts

@@ -308,6 +308,7 @@ declare const EntityInvestorParticipationSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -589,6 +590,7 @@ declare const EntityInvestorParticipationSchemaDefinition: 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/entity/list-filter.js

@@ -61,7 +61,7 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     portfolioHeadquartersCountry: z.array(z.string()).optional(),
     /** Portfolio-company headquarters state or region values. */
     portfolioHeadquartersState: z.array(z.string()).optional(),
-    /** Named server-owned list quality gate. */
+    /** Server-owned list quality gate. */
     qualityGate: EntityListQualityGateSchema.optional(),
     /** Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean. */
     rankByProminence: z.boolean().nullish(),
@@ -80,7 +80,7 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     suppressLateStage: z.boolean().nullish(),
     /** Suppress entities with terminal operating status. */
     suppressNonOperating: z.boolean().nullish(),
-    /** Suppress entities whose USD-converted total raised is zero or unknown. */
+    /** Suppress entities with zero or unknown USD total raised. */
     suppressZeroTotalRaised: z.boolean().nullish(),
     /** General classification tag values. */
     tag: z.array(z.string()).optional(),

package/dist/entity/list.d.ts

@@ -307,6 +307,7 @@ declare const EntityListSchemaDefinition: z.ZodObject<{
             totalRaisedUsd?: number | null | undefined;
             unconvertedRoundCount: number;
         } | null | undefined;
+        headquartersAddressId?: number | null | undefined;
         text: {
             expanded?: string | null | undefined;
             generatedDescription?: string | null | undefined;
@@ -588,6 +589,7 @@ declare const EntityListSchemaDefinition: 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/entity/natural-search.d.ts

@@ -174,12 +174,14 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
         }, unknown>>>>;
     }, z.core.$strict>>;
     search: z.ZodType<{
+        answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
+        answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;

package/dist/entity/person-association.js

@@ -44,7 +44,7 @@ export const EntityPersonAssociationSchema = z.object({
         .string()
         .regex(/^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-][0-9]{2}:[0-5][0-9]))?)?)?$/)
         .nullish(),
-    /** Entity addresses carried on the association projection */
+    /** Entity addresses carried on the association projection. Person detail carries at most one: the entity's current headquarters, else its most recently updated current address; GET /v1/entities/{entityId}/addresses lists them all */
     entityAddress: z.array(AddressSchema),
     /** Associated entity id */
     entityId: z.uuid(),

package/dist/entity/resolution.d.ts

@@ -309,6 +309,7 @@ declare const EntityResolutionSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -590,6 +591,7 @@ declare const EntityResolutionSchemaDefinition: 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/entity/similarity-result.d.ts

@@ -290,6 +290,7 @@ declare const EntitySimilarityResultSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -767,6 +768,7 @@ declare const EntitySimilarityResultSchemaDefinition: 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/federated/natural-search.d.ts

@@ -1,5 +1,16 @@
 import { z } from "zod/v4";
-declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
+/**
+ * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
+ *
+ * @openapiSchema FederatedNaturalSearch
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SharedSearchMutationSchema
+ * @contractShape federated.natural-search
+ * @contractRole canonical
+ */
+export declare const FederatedNaturalSearchSchema: z.ZodObject<{
+    answerModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cacheMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
         bypass: "bypass";
         refresh: "refresh";
@@ -199,16 +210,5 @@ declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
         xhigh: "xhigh";
     }>, z.ZodString]>>>;
 }, z.core.$strip>;
-type FederatedNaturalSearchDefinition = z.infer<typeof FederatedNaturalSearchSchemaDefinition>;
-/**
- * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
- *
- * @openapiSchema FederatedNaturalSearch
- * @endpoint POST /v1/search
- * @contractShape federated.natural-search
- * @contractRole canonical
- */
-export declare const FederatedNaturalSearchSchema: z.ZodType<FederatedNaturalSearchDefinition>;
 export type FederatedNaturalSearch = z.infer<typeof FederatedNaturalSearchSchema>;
-export {};
 //# sourceMappingURL=natural-search.d.ts.map

package/dist/federated/natural-search.js

@@ -4,8 +4,20 @@ import { EntityFilterSchema } from "../entity/filter.js";
 import { ReasoningEffortSchema } from "../reasoning/effort.js";
 import { SearchCacheModeSchema } from "../search/cache-mode.js";
 import { SearchModeSchema } from "../search/mode.js";
-const FederatedNaturalSearchSchemaDefinition = 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. */
+/**
+ * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
+ *
+ * @openapiSchema FederatedNaturalSearch
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SharedSearchMutationSchema
+ * @contractShape federated.natural-search
+ * @contractRole canonical
+ */
+export const FederatedNaturalSearchSchema = z.object({
+    /** 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(),
     /** Explicit entity constraints for the entity scope only, as on POST /v1/search/natural/entities: caller-supplied fields override planner values. The person and news scopes ignore it. */
     entityFilter: EntityFilterSchema.optional(),
@@ -22,13 +34,4 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Callers without private-data access are capped at `medium`. Null keeps the configured per-call and per-model defaults. */
     reasoningEffort: ReasoningEffortSchema.nullish(),
 });
-/**
- * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
- *
- * @openapiSchema FederatedNaturalSearch
- * @endpoint POST /v1/search
- * @contractShape federated.natural-search
- * @contractRole canonical
- */
-export const FederatedNaturalSearchSchema = FederatedNaturalSearchSchemaDefinition;
 //# sourceMappingURL=natural-search.js.map

package/dist/federated/search.d.ts

@@ -9,6 +9,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
             description?: string | null | undefined;
+            heading?: string | null | undefined;
             paragraph: {
                 citation: {
                     entityId: string;
@@ -146,7 +147,7 @@ declare const FederatedSearchSchemaDefinition: 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;
@@ -618,6 +619,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         totalRaisedUsd?: number | null | undefined;
                         unconvertedRoundCount: number;
                     } | null | undefined;
+                    headquartersAddressId?: number | null | undefined;
                     text: {
                         expanded?: string | null | undefined;
                         generatedDescription?: string | null | undefined;
@@ -1111,6 +1113,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         totalRaisedUsd?: number | null | undefined;
                         unconvertedRoundCount: number;
                     } | null | undefined;
+                    headquartersAddressId?: number | null | undefined;
                     text: {
                         expanded?: string | null | undefined;
                         generatedDescription?: string | null | undefined;
@@ -1595,6 +1598,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -1792,6 +1796,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
             description?: string | null | undefined;
+            heading?: string | null | undefined;
             paragraph: {
                 citation: {
                     entityId: string;
@@ -1929,7 +1934,7 @@ declare const FederatedSearchSchemaDefinition: 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;
@@ -2401,6 +2406,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         totalRaisedUsd?: number | null | undefined;
                         unconvertedRoundCount: number;
                     } | null | undefined;
+                    headquartersAddressId?: number | null | undefined;
                     text: {
                         expanded?: string | null | undefined;
                         generatedDescription?: string | null | undefined;
@@ -2894,6 +2900,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         totalRaisedUsd?: number | null | undefined;
                         unconvertedRoundCount: number;
                     } | null | undefined;
+                    headquartersAddressId?: number | null | undefined;
                     text: {
                         expanded?: string | null | undefined;
                         generatedDescription?: string | null | undefined;
@@ -3378,6 +3385,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                     totalRaisedUsd?: number | null | undefined;
                     unconvertedRoundCount: number;
                 } | null | undefined;
+                headquartersAddressId?: number | null | undefined;
                 text: {
                     expanded?: string | null | undefined;
                     generatedDescription?: string | null | undefined;
@@ -3875,6 +3883,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 totalRaisedUsd?: number | null | undefined;
                 unconvertedRoundCount: number;
             } | null | undefined;
+            headquartersAddressId?: number | null | undefined;
             text: {
                 expanded?: string | null | undefined;
                 generatedDescription?: string | null | undefined;
@@ -4156,6 +4165,7 @@ declare const FederatedSearchSchemaDefinition: 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/harness/task-plan-step.d.ts

@@ -11,6 +11,14 @@ declare const HarnessTaskPlanStepSchemaDefinition: z.ZodObject<{
         operationId: string;
         stepKey: string;
     }, unknown>>;
+    writeGuidance: z.ZodOptional<z.ZodNullable<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>>>;
 }, z.core.$strip>;
 type HarnessTaskPlanStepDefinition = z.infer<typeof HarnessTaskPlanStepSchemaDefinition>;
 /**

package/dist/harness/task-plan-step.js

@@ -1,6 +1,7 @@
 // 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";
+import { HarnessTaskWriteGuidanceSchema } from "./task-write-guidance.js";
 const HarnessTaskPlanStepSchemaDefinition = z.object({
     /** CLI command path that runs the step's operation; the caller supplies required flags. */
     cliCommand: z.string(),
@@ -8,6 +9,8 @@ const HarnessTaskPlanStepSchemaDefinition = z.object({
     mcpTool: z.string().nullish(),
     /** The stored step. */
     step: HarnessTaskStepSchema,
+    /** What the server expects of the prose this step writes, derived from the operation's judged prose type when the plan is read; null when the step writes no judged prose. */
+    writeGuidance: HarnessTaskWriteGuidanceSchema.nullish(),
 });
 /**
  * One task step with the CLI command and MCP tool that run its operation.

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

@@ -29,6 +29,14 @@ export declare const HarnessTaskPlanSchema: 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;
@@ -37,6 +45,14 @@ export declare const HarnessTaskPlanSchema: 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>;