@aventurevc/api-schemas 0.8.136 → 0.8.139

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

@@ -180,6 +180,7 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
         model?: string | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
+        searchCatalogRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput, z.core.$ZodTypeInternals<{
         answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
@@ -187,6 +188,7 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
         model?: string | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
+        searchCatalogRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput>>;
 }, z.core.$strip>;
 type EntityNaturalSearchDefinition = z.infer<typeof EntityNaturalSearchSchemaDefinition>;

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

@@ -199,6 +199,7 @@ declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
         minimal: "minimal";
         xhigh: "xhigh";
     }>, z.ZodString]>>>;
+    searchCatalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;
 type FederatedNaturalSearchDefinition = z.infer<typeof FederatedNaturalSearchSchemaDefinition>;
 export interface FederatedNaturalSearchSchemaInput extends z.input<typeof FederatedNaturalSearchSchemaDefinition> {

package/dist/federated/natural-search.js

@@ -23,6 +23,8 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     query: z.string().min(1),
     /** 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(),
+    /** Search catalog revision this search reads its qualifier prompts and startup vocabulary from, to compare catalog edits; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
+    searchCatalogRevision: z.int().nullish(),
 });
 /**
  * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.

package/dist/federated/search.d.ts

@@ -6866,6 +6866,17 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         }[];
         unavailable: ("entity" | "news" | "person")[];
     }, import("./search-provenance.ts").FederatedSearchProvenanceSchemaInput>>;
+    qualifier: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+        option: z.ZodArray<z.ZodType<{
+            label: string;
+            query: string;
+        }, import("../search/qualifier-option.ts").SearchQualifierOptionSchemaInput, z.core.$ZodTypeInternals<{
+            label: string;
+            query: string;
+        }, import("../search/qualifier-option.ts").SearchQualifierOptionSchemaInput>>>;
+        prompt: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type FederatedSearchDefinition = z.infer<typeof FederatedSearchSchemaDefinition>;
 export interface FederatedSearchSchemaInput extends z.input<typeof FederatedSearchSchemaDefinition> {

package/dist/federated/search.js

@@ -7,6 +7,7 @@ import { NewsEntityMentionSchema } from "../news/entity-mention.js";
 import { PageResultNewsSchema } from "../pagination/schemas.js";
 import { PersonDetailSchema } from "../person/detail.js";
 import { PersonNaturalSearchResultSchema } from "../person/natural-search-result.js";
+import { SearchQualifierSchema } from "../search/qualifier.js";
 const FederatedSearchSchemaDefinition = z.object({
     /** Canonical entity natural-search result. */
     entity: NaturalSearchResultSchema,
@@ -22,6 +23,8 @@ const FederatedSearchSchemaDefinition = z.object({
     personDetail: z.array(PersonDetailSchema),
     /** Requested and executed strategy for each search scope. */
     provenance: FederatedSearchProvenanceSchema,
+    /** A prompt with rewritten queries offered beside a broad query's results, from the search catalog revision the search read; null when no qualifier rule matches. */
+    qualifier: SearchQualifierSchema.nullish(),
 });
 /**
  * Federated entity, person, and news search result composed from each domain's canonical search result owner, with the strategy used for every scope.

package/dist/link/search.d.ts

@@ -3454,6 +3454,14 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             }[];
             unavailable: ("entity" | "news" | "person")[];
         };
+        qualifier?: {
+            key: string;
+            option: {
+                label: string;
+                query: string;
+            }[];
+            prompt: string;
+        } | null | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput, z.core.$ZodTypeInternals<{
         entity: {
             answer?: {
@@ -6907,6 +6915,14 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             }[];
             unavailable: ("entity" | "news" | "person")[];
         };
+        qualifier?: {
+            key: string;
+            option: {
+                label: string;
+                query: string;
+            }[];
+            prompt: string;
+        } | null | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput>>;
     url: z.ZodString;
 }, z.core.$strip>;

package/dist/natural/search.d.ts

@@ -24,6 +24,7 @@ declare const NaturalSearchSchemaDefinition: z.ZodObject<{
         minimal: "minimal";
         xhigh: "xhigh";
     }>, z.ZodString]>>>;
+    searchCatalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;
 type NaturalSearchDefinition = z.infer<typeof NaturalSearchSchemaDefinition>;
 export interface NaturalSearchSchemaInput extends z.input<typeof NaturalSearchSchemaDefinition> {

package/dist/natural/search.js

@@ -16,6 +16,8 @@ const NaturalSearchSchemaDefinition = z.object({
     query: z.string().min(1),
     /** 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(),
+    /** Search catalog revision this search reads its qualifier prompts and startup vocabulary from, to compare catalog edits; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
+    searchCatalogRevision: z.int().nullish(),
 });
 /**
  * Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.

package/dist/openapi-component-manifest.js

@@ -888,6 +888,11 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "SearchOrderingPersonSortFieldSchema",
     },
     SearchPassage: { modulePath: "search/passage", schemaName: "SearchPassageSchema" },
+    SearchQualifier: { modulePath: "search/qualifier", schemaName: "SearchQualifierSchema" },
+    SearchQualifierOption: {
+        modulePath: "search/qualifier-option",
+        schemaName: "SearchQualifierOptionSchema",
+    },
     SearchRelevance: { modulePath: "search/relevance", schemaName: "SearchRelevanceSchema" },
     SecCompany: { modulePath: "sec/company", schemaName: "SecCompanySchema" },
     SecListingProspectus: {

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

@@ -271,6 +271,7 @@ declare const PersonNaturalSearchSchemaDefinition: z.ZodObject<{
         model?: string | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
+        searchCatalogRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput, z.core.$ZodTypeInternals<{
         answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
@@ -278,6 +279,7 @@ declare const PersonNaturalSearchSchemaDefinition: z.ZodObject<{
         model?: string | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
+        searchCatalogRevision?: number | null | undefined;
     }, import("../natural/search.ts").NaturalSearchSchemaInput>>;
 }, z.core.$strip>;
 type PersonNaturalSearchDefinition = z.infer<typeof PersonNaturalSearchSchemaDefinition>;

package/dist/research/snippet-type.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod/v4";
 declare const ResearchSnippetTypeSchemaDefinition: z.ZodObject<{
     analysisRenderable: z.ZodBoolean;
+    analysisSectionLabel: z.ZodOptional<z.ZodArray<z.ZodString>>;
     curated: z.ZodBoolean;
     defaultVisible: z.ZodBoolean;
     label: z.ZodString;

package/dist/research/snippet-type.js

@@ -4,6 +4,8 @@ import { ResearchParagraphShapeSchema } from "./paragraph-shape.js";
 const ResearchSnippetTypeSchemaDefinition = z.object({
     /** Whether curated rows of this snippet type can make the public company Analysis page eligible. */
     analysisRenderable: z.boolean(),
+    /** Ordered headings for the fixed paragraphs of a framework analysis. Empty means ordinary prose; preserve legacy prose when its paragraph count differs. */
+    analysisSectionLabel: z.array(z.string()).optional(),
     /** Whether the type is curated; with analysisRenderable this gates public Analysis-page eligibility. It does not gate snippet display — every type listed here is recognized and defaults to visible, and the row-level visible flag controls display. */
     curated: z.boolean(),
     /** Default visible flag when a write omits visible; true for recognized snippet types even when curated=false. */

package/dist/search/qualifier-option.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+declare const SearchQualifierOptionSchemaDefinition: z.ZodObject<{
+    label: z.ZodString;
+    query: z.ZodString;
+}, z.core.$strip>;
+type SearchQualifierOptionDefinition = z.infer<typeof SearchQualifierOptionSchemaDefinition>;
+export interface SearchQualifierOptionSchemaInput extends z.input<typeof SearchQualifierOptionSchemaDefinition> {
+}
+/**
+ * One rewritten query a qualifier offers.
+ *
+ * @openapiSchema SearchQualifierOption
+ * @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/shared
+ * @usedBySchema SearchQualifierSchema
+ * @contractShape search.qualifier-option
+ * @contractRole canonical
+ */
+export declare const SearchQualifierOptionSchema: z.ZodType<SearchQualifierOptionDefinition, SearchQualifierOptionSchemaInput>;
+export type SearchQualifierOption = z.infer<typeof SearchQualifierOptionSchema>;
+export {};
+//# sourceMappingURL=qualifier-option.d.ts.map

package/dist/search/qualifier-option.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";
+const SearchQualifierOptionSchemaDefinition = z.object({
+    /** Option label. */
+    label: z.string(),
+    /** Search query the option runs. */
+    query: z.string(),
+});
+/**
+ * One rewritten query a qualifier offers.
+ *
+ * @openapiSchema SearchQualifierOption
+ * @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/shared
+ * @usedBySchema SearchQualifierSchema
+ * @contractShape search.qualifier-option
+ * @contractRole canonical
+ */
+export const SearchQualifierOptionSchema = SearchQualifierOptionSchemaDefinition;
+//# sourceMappingURL=qualifier-option.js.map

package/dist/search/qualifier.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod/v4";
+/**
+ * A prompt offered beside a broad query's results, with rewritten queries that narrow or widen it.
+ *
+ * @openapiSchema SearchQualifier
+ * @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/shared
+ * @usedBySchema FederatedSearchSchema
+ * @contractShape search.qualifier
+ * @contractRole canonical
+ */
+export declare const SearchQualifierSchema: z.ZodObject<{
+    key: z.ZodString;
+    option: z.ZodArray<z.ZodType<{
+        label: string;
+        query: string;
+    }, import("./qualifier-option.ts").SearchQualifierOptionSchemaInput, z.core.$ZodTypeInternals<{
+        label: string;
+        query: string;
+    }, import("./qualifier-option.ts").SearchQualifierOptionSchemaInput>>>;
+    prompt: z.ZodString;
+}, z.core.$strip>;
+export type SearchQualifier = z.infer<typeof SearchQualifierSchema>;
+//# sourceMappingURL=qualifier.d.ts.map

package/dist/search/qualifier.js

@@ -0,0 +1,26 @@
+// 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 { SearchQualifierOptionSchema } from "./qualifier-option.js";
+/**
+ * A prompt offered beside a broad query's results, with rewritten queries that narrow or widen it.
+ *
+ * @openapiSchema SearchQualifier
+ * @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/shared
+ * @usedBySchema FederatedSearchSchema
+ * @contractShape search.qualifier
+ * @contractRole canonical
+ */
+export const SearchQualifierSchema = z.object({
+    /** Stable qualifier key. */
+    key: z.string(),
+    /** Rewritten queries the reader can run instead, in display order. */
+    option: z.array(SearchQualifierOptionSchema),
+    /** Text shown above the options. */
+    prompt: z.string(),
+});
+//# sourceMappingURL=qualifier.js.map

package/dist/shared/search.d.ts

@@ -3465,6 +3465,14 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
             }[];
             unavailable: ("entity" | "news" | "person")[];
         };
+        qualifier?: {
+            key: string;
+            option: {
+                label: string;
+                query: string;
+            }[];
+            prompt: string;
+        } | null | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput, z.core.$ZodTypeInternals<{
         entity: {
             answer?: {
@@ -6918,6 +6926,14 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
             }[];
             unavailable: ("entity" | "news" | "person")[];
         };
+        qualifier?: {
+            key: string;
+            option: {
+                label: string;
+                query: string;
+            }[];
+            prompt: string;
+        } | null | undefined;
     }, import("../federated/search.ts").FederatedSearchSchemaInput>>;
 }, z.core.$strip>;
 type SharedSearchDefinition = z.infer<typeof SharedSearchSchemaDefinition>;

package/package.json

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