@aventurevc/api-schemas 0.8.100 → 0.8.102

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

@@ -136,6 +136,7 @@ declare const EntityFilterSearchSchemaDefinition: z.ZodObject<{
             COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
             NONE: "NONE";
         }>>;
+        rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
         stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
         suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/entity/filter.d.ts

@@ -154,6 +154,7 @@ export declare const EntityFilterSchema: z.ZodObject<{
         COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
         NONE: "NONE";
     }>>;
+    rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
     stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
     suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/entity/filter.js

@@ -83,6 +83,8 @@ export const EntityFilterSchema = z.strictObject({
     portfolioHeadquartersState: z.array(z.string()).optional(),
     /** Named 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(),
     /** Restrict results to entity slugs. */
     slug: z
         .array(z

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

@@ -132,6 +132,7 @@ declare const EntityListFilterSchemaDefinition: z.ZodObject<{
         COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
         NONE: "NONE";
     }>>;
+    rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     semanticQuery: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
     stage: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/entity/list-filter.js

@@ -61,6 +61,8 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     portfolioHeadquartersState: z.array(z.string()).optional(),
     /** Named 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(),
     /** Semantic entity search phrase. Executable on POST /v1/entities/search; saved views persist it for replay. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching entity. */
     semanticQuery: z.string().nullish(),
     /** Restrict results to entity slugs. */

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

@@ -133,6 +133,7 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
             COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
             NONE: "NONE";
         }>>;
+        rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
         stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
         suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

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

@@ -138,6 +138,7 @@ declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
             COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
             NONE: "NONE";
         }>>;
+        rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
         stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
         suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/federated/search.d.ts

@@ -116,6 +116,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 portfolioHeadquartersCountry?: string[] | undefined;
                 portfolioHeadquartersState?: string[] | undefined;
                 qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                rankByProminence?: boolean | null | undefined;
                 semanticQuery?: string | null | undefined;
                 slug?: string[] | undefined;
                 stage?: string[] | undefined;
@@ -2366,6 +2367,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 portfolioHeadquartersCountry?: string[] | undefined;
                 portfolioHeadquartersState?: string[] | undefined;
                 qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                rankByProminence?: boolean | null | undefined;
                 semanticQuery?: string | null | undefined;
                 slug?: string[] | undefined;
                 stage?: string[] | undefined;
@@ -6473,6 +6475,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;
                     qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                    rankByProminence?: boolean | null | undefined;
                     slug?: string[] | undefined;
                     stage?: string[] | undefined;
                     suppressNonOperating?: boolean | null | undefined;
@@ -6830,6 +6833,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;
                     qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                    rankByProminence?: boolean | null | undefined;
                     slug?: string[] | undefined;
                     stage?: string[] | undefined;
                     suppressNonOperating?: boolean | null | undefined;

package/dist/harness/run-create.d.ts

@@ -1,12 +1,12 @@
 import { z } from "zod/v4";
 declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
     finding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
-        gateId: string;
+        gateId?: string | null | undefined;
         quote: string;
         sourceUrl: string;
         statement: string;
     }, unknown, z.core.$ZodTypeInternals<{
-        gateId: string;
+        gateId?: string | null | undefined;
         quote: string;
         sourceUrl: string;
         statement: string;

package/dist/http/route.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The one method-plus-path matching rule for aVenture API operations. The MCP server resolves an
+ * `aventure_*` call that names a method and path with it, and `operation/route` answers the same
+ * question for callers that only hold that method and path.
+ *
+ * @shared primitive:multi route matching for MCP and its consumers; not generated from OpenAPI
+ * @contractShape http.route
+ * @contractRole canonical
+ * @ownerModule http/route.ts
+ */
+/** The path a request names, without its query string or fragment. */
+export declare function pathWithoutQuery(path: string): string;
+/**
+ * A concrete request path matches a template when both have the same segment count and each
+ * template segment is either the same literal or one `{name}` parameter. A path that still carries
+ * a raw or percent-encoded `{name}` segment matches nothing, because it never filled the parameter.
+ */
+export declare function routeTemplateMatches(template: string, path: string): boolean;
+//# sourceMappingURL=route.d.ts.map

package/dist/http/route.js

@@ -0,0 +1,52 @@
+// Generated alternate api-schemas support copy from TypeScript source api-schemas/http/route.ts
+/**
+ * The one method-plus-path matching rule for aVenture API operations. The MCP server resolves an
+ * `aventure_*` call that names a method and path with it, and `operation/route` answers the same
+ * question for callers that only hold that method and path.
+ *
+ * @shared primitive:multi route matching for MCP and its consumers; not generated from OpenAPI
+ * @contractShape http.route
+ * @contractRole canonical
+ * @ownerModule http/route.ts
+ */
+/** The path a request names, without its query string or fragment. */
+export function pathWithoutQuery(path) {
+    return new URL(path, "https://placeholder.invalid").pathname;
+}
+/**
+ * A concrete request path matches a template when both have the same segment count and each
+ * template segment is either the same literal or one `{name}` parameter. A path that still carries
+ * a raw or percent-encoded `{name}` segment matches nothing, because it never filled the parameter.
+ */
+export function routeTemplateMatches(template, path) {
+    const templateParts = template.split("/").filter(Boolean);
+    const pathParts = path.split("/").filter(Boolean);
+    if (templateParts.length !== pathParts.length)
+        return false;
+    if (pathParts.some(isUnresolvedTemplateSegment))
+        return false;
+    return templateParts.every((templatePart, index) => isOpenApiTemplateSegment(templatePart) || templatePart === pathParts[index]);
+}
+function isOpenApiTemplateSegment(pathSegment) {
+    const innerSegment = pathSegment.slice(1, -1);
+    return (pathSegment.startsWith("{") &&
+        pathSegment.endsWith("}") &&
+        innerSegment.length > 0 &&
+        !innerSegment.includes("/") &&
+        !innerSegment.includes("{") &&
+        !innerSegment.includes("}"));
+}
+function isUnresolvedTemplateSegment(pathSegment) {
+    if (isOpenApiTemplateSegment(pathSegment))
+        return true;
+    const lowerSegment = pathSegment.toLowerCase();
+    const innerSegment = pathSegment.slice(3, -3);
+    return (lowerSegment.startsWith("%7b") &&
+        lowerSegment.endsWith("%7d") &&
+        innerSegment.length > 0 &&
+        !innerSegment.includes("/") &&
+        !innerSegment.includes("%") &&
+        !innerSegment.includes("{") &&
+        !innerSegment.includes("}"));
+}
+//# sourceMappingURL=route.js.map

package/dist/link/search.d.ts

@@ -118,6 +118,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;
                     qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                    rankByProminence?: boolean | null | undefined;
                     semanticQuery?: string | null | undefined;
                     slug?: string[] | undefined;
                     stage?: string[] | undefined;
@@ -3313,6 +3314,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                         portfolioHeadquartersCountry?: string[] | undefined;
                         portfolioHeadquartersState?: string[] | undefined;
                         qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                        rankByProminence?: boolean | null | undefined;
                         slug?: string[] | undefined;
                         stage?: string[] | undefined;
                         suppressNonOperating?: boolean | null | undefined;
@@ -4028,6 +4030,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;
                     qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                    rankByProminence?: boolean | null | undefined;
                     semanticQuery?: string | null | undefined;
                     slug?: string[] | undefined;
                     stage?: string[] | undefined;
@@ -7223,6 +7226,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                         portfolioHeadquartersCountry?: string[] | undefined;
                         portfolioHeadquartersState?: string[] | undefined;
                         qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                        rankByProminence?: boolean | null | undefined;
                         slug?: string[] | undefined;
                         stage?: string[] | undefined;
                         suppressNonOperating?: boolean | null | undefined;

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

@@ -131,6 +131,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             portfolioHeadquartersCountry?: string[] | undefined;
             portfolioHeadquartersState?: string[] | undefined;
             qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+            rankByProminence?: boolean | null | undefined;
             semanticQuery?: string | null | undefined;
             slug?: string[] | undefined;
             stage?: string[] | undefined;
@@ -258,6 +259,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             portfolioHeadquartersCountry?: string[] | undefined;
             portfolioHeadquartersState?: string[] | undefined;
             qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+            rankByProminence?: boolean | null | undefined;
             semanticQuery?: string | null | undefined;
             slug?: string[] | undefined;
             stage?: string[] | undefined;

package/dist/person/filter.d.ts

@@ -188,6 +188,7 @@ export declare const PersonFilterSchema: z.ZodObject<{
             COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
             NONE: "NONE";
         }>>;
+        rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
         stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
         suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

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

@@ -113,6 +113,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
                 portfolioHeadquartersCountry?: string[] | undefined;
                 portfolioHeadquartersState?: string[] | undefined;
                 qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                rankByProminence?: boolean | null | undefined;
                 slug?: string[] | undefined;
                 stage?: string[] | undefined;
                 suppressNonOperating?: boolean | null | undefined;
@@ -294,6 +295,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
                 portfolioHeadquartersCountry?: string[] | undefined;
                 portfolioHeadquartersState?: string[] | undefined;
                 qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                rankByProminence?: boolean | null | undefined;
                 slug?: string[] | undefined;
                 stage?: string[] | undefined;
                 suppressNonOperating?: boolean | null | undefined;

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

@@ -172,6 +172,7 @@ declare const PersonNaturalSearchSchemaDefinition: z.ZodObject<{
                 COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
                 NONE: "NONE";
             }>>;
+            rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
             stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
             suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

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

@@ -185,6 +185,7 @@ declare const PersonSearchInterpretationSchemaDefinition: z.ZodObject<{
                 COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
                 NONE: "NONE";
             }>>;
+            rankByProminence: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
             stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
             suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/research/finding.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 declare const ResearchFindingSchemaDefinition: z.ZodObject<{
-    gateId: z.ZodString;
+    gateId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     quote: z.ZodString;
     sourceUrl: z.ZodString;
     statement: z.ZodString;

package/dist/research/finding.js

@@ -1,9 +1,9 @@
 // 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 ResearchFindingSchemaDefinition = z.object({
-    /** Completion gate id the fact fills, from the completion contract. */
-    gateId: z.string(),
-    /** The exact text on sourceUrl that supports the fact, copied verbatim. */
+    /** Completion gate the fact fills, when known; omit it and the run picks the field the fact belongs to. */
+    gateId: z.string().nullish(),
+    /** The exact text on sourceUrl that states the fact, copied verbatim; a fragment short enough to appear on any page is refused. */
     quote: z.string(),
     /** Absolute http or https URL of the page that supports the fact; aVenture pages are refused. */
     sourceUrl: z.string(),

package/dist/search/interpretation.d.ts

@@ -99,6 +99,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
         portfolioHeadquartersCountry?: string[] | undefined;
         portfolioHeadquartersState?: string[] | undefined;
         qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+        rankByProminence?: boolean | null | undefined;
         semanticQuery?: string | null | undefined;
         slug?: string[] | undefined;
         stage?: string[] | undefined;
@@ -206,6 +207,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
         portfolioHeadquartersCountry?: string[] | undefined;
         portfolioHeadquartersState?: string[] | undefined;
         qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+        rankByProminence?: boolean | null | undefined;
         semanticQuery?: string | null | undefined;
         slug?: string[] | undefined;
         stage?: string[] | undefined;

package/dist/search/search.d.ts

@@ -3,6 +3,7 @@ declare const SearchSchemaDefinition: z.ZodObject<{
     allowSuspectedShellStrip: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     bypassCache: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     cacheKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deep: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     resultLimit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;

package/dist/search/search.js

@@ -8,6 +8,8 @@ const SearchSchemaDefinition = z.object({
     bypassCache: z.boolean().default(false).optional(),
     /** Stable lookup text for cache keying when generated search text varies between runs */
     cacheKey: z.string().nullish(),
+    /** Run Exa's slower, broader deep search instead of the default provider: higher recall for market and provider questions, about 3-6 s per search, answered synchronously (`Prefer: respond-async` does not apply). Charged like any search. */
+    deep: z.boolean().default(false).optional(),
     /** Search language code */
     language: z.string().nullish(),
     /** Search region code */

package/dist/shared/search.d.ts

@@ -128,6 +128,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;
                     qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                    rankByProminence?: boolean | null | undefined;
                     semanticQuery?: string | null | undefined;
                     slug?: string[] | undefined;
                     stage?: string[] | undefined;
@@ -3323,6 +3324,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                         portfolioHeadquartersCountry?: string[] | undefined;
                         portfolioHeadquartersState?: string[] | undefined;
                         qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                        rankByProminence?: boolean | null | undefined;
                         slug?: string[] | undefined;
                         stage?: string[] | undefined;
                         suppressNonOperating?: boolean | null | undefined;
@@ -4038,6 +4040,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     portfolioHeadquartersCountry?: string[] | undefined;
                     portfolioHeadquartersState?: string[] | undefined;
                     qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                    rankByProminence?: boolean | null | undefined;
                     semanticQuery?: string | null | undefined;
                     slug?: string[] | undefined;
                     stage?: string[] | undefined;
@@ -7233,6 +7236,7 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                         portfolioHeadquartersCountry?: string[] | undefined;
                         portfolioHeadquartersState?: string[] | undefined;
                         qualityGate?: "COMPANY_LISTING_READY" | "NONE" | undefined;
+                        rankByProminence?: boolean | null | undefined;
                         slug?: string[] | undefined;
                         stage?: string[] | undefined;
                         suppressNonOperating?: boolean | null | undefined;

package/dist/web/search.d.ts

@@ -46,6 +46,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
+        deep?: boolean | undefined;
         language?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;
@@ -59,6 +60,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
+        deep?: boolean | undefined;
         language?: string | null | undefined;
         region?: string | null | undefined;
         resultLimit?: number | null | undefined;

package/package.json

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