@aventurevc/api-schemas 0.7.301 → 0.7.328

package/dist/person/person.js

@@ -1,7 +1,6 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
 import { ContentEmbeddingMatchSchema } from "../content/embedding-match.js";
-import { DatasourceSourceMetadataSchema } from "../datasource/source-metadata.js";
 import { EntityNameAliasPersonAliasTypeSchema } from "../entity/name-alias-person-alias-type.js";
 import { EntityTextBundleSchema } from "../entity/text-bundle.js";
 import { PersonImageSchema } from "./image.js";
@@ -33,7 +32,6 @@ const PersonSchemaDefinition = z.object({
         .string()
         .regex(/^[a-z0-9_-]+$/)
         .max(255),
-    source: DatasourceSourceMetadataSchema,
     suffix: z.string().nullish(),
     /** Grouped person text content */
     text: EntityTextBundleSchema,
@@ -44,10 +42,7 @@ const PersonSchemaDefinition = z.object({
  * Canonical person core record
  *
  * @openapiSchema Person
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -55,17 +50,14 @@ const PersonSchemaDefinition = z.object({
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/people/natural-search
  * @endpoint POST /v1/people/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema PagePersonSchema
  * @usedBySchema PageResultPersonSchema
  * @usedBySchema PersonDetailSchema

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

@@ -97,6 +97,7 @@ declare const PersonSearchInterpretationSchemaDefinition: z.ZodObject<{
         isCurrent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         letter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        personId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
         personName: z.ZodOptional<z.ZodArray<z.ZodString>>;
         role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -127,6 +128,7 @@ type PersonSearchInterpretationDefinition = z.infer<typeof PersonSearchInterpret
  * @endpoint GET /v1/search/link
  * @endpoint POST /v1/people/natural-search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema PersonNaturalSearchResultSchema
  * @contractShape person.search-interpretation
  * @contractRole canonical

package/dist/person/search-interpretation.js

@@ -27,6 +27,7 @@ const PersonSearchInterpretationSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link
  * @endpoint POST /v1/people/natural-search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema PersonNaturalSearchResultSchema
  * @contractShape person.search-interpretation
  * @contractRole canonical

package/dist/person/search-param.js

@@ -14,11 +14,11 @@ export const PERSON_SEARCH_ENDPOINT = "/v1/people/search";
 export const PersonSearchParamSchema = PageParamSchema.extend({
     /** When true, return only the page total in the body and skip the content payload. */
     countOnly: z.boolean().optional(),
-    /** Opaque semantic-search continuation from X-Next-Cursor. Repeat the same filters, sort, and size. */
+    /** Opaque continuation from X-Next-Cursor. Repeat the same filters and size; a semantic cursor also repeats sort, a keyset cursor omits it. */
     cursor: z.string().optional(),
     /** When true, sort people who have a photo before those who do not. */
     hasImageFirst: z.boolean().optional(),
-    /** Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published records are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public. */
+    /** Includes hidden, unverified, and not-yet-published records when the caller has private-visibility authority. Omit to use the caller's default visibility. */
     includePrivate: z.boolean().optional(),
     /** When false, monogram fallback logos are stripped from the response. Defaults to true. */
     permitMonogram: z.boolean().optional(),

package/dist/person/similarity-result.d.ts

@@ -2,8 +2,6 @@ import { z } from "zod/v4";
 declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
     currentRole: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         associationId: z.ZodInt;
-        createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
-        creator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         endDate: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         entityAddress: z.ZodArray<z.ZodObject<{
             address: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -212,7 +210,6 @@ declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
         titleId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         titleLevel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         titleName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     }, z.core.$strip>>>;
     person: z.ZodType<{
         createdAt?: string | null | undefined;
@@ -247,15 +244,6 @@ declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
             sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
         } | null | undefined;
         slug: string;
-        source: {
-            changedAt?: string | null | undefined;
-            dataSourceUpdatedAt?: string | null | undefined;
-            detail?: string | null | undefined;
-            kind?: string | null | undefined;
-            pendingApproval?: number | null | undefined;
-            sourceId?: string | null | undefined;
-            status?: string | null | undefined;
-        };
         suffix?: string | null | undefined;
         text: {
             expanded?: string | null | undefined;
@@ -296,15 +284,6 @@ declare const PersonSimilarityResultSchemaDefinition: z.ZodObject<{
             sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
         } | null | undefined;
         slug: string;
-        source: {
-            changedAt?: string | null | undefined;
-            dataSourceUpdatedAt?: string | null | undefined;
-            detail?: string | null | undefined;
-            kind?: string | null | undefined;
-            pendingApproval?: number | null | undefined;
-            sourceId?: string | null | undefined;
-            status?: string | null | undefined;
-        };
         suffix?: string | null | undefined;
         text: {
             expanded?: string | null | undefined;

package/dist/problem/type.d.ts

@@ -41,6 +41,7 @@ export declare const ProblemTypeSchema: z.ZodEnum<{
     readonly PRECONDITION_FAILED: "https://api.aventure.vc/errors/precondition-failed";
     readonly PRECONDITION_REQUIRED: "https://api.aventure.vc/errors/precondition-required";
     readonly BILLING_ALLOWANCE_EXHAUSTED: "https://api.aventure.vc/errors/billing-allowance-exhausted";
+    readonly BILLING_ADDITIONAL_USAGE_CAP_REACHED: "https://api.aventure.vc/errors/billing-additional-usage-cap-reached";
     readonly SUBSCRIPTION_REQUIRED: "https://api.aventure.vc/errors/subscription-required";
     readonly SERVICE_UNAVAILABLE: "https://api.aventure.vc/errors/service-unavailable";
     readonly MALFORMED_FORM_BODY: "https://api.aventure.vc/errors/malformed-form-body";

package/dist/problem/type.js

@@ -42,6 +42,7 @@ export const ProblemTypeSchema = z.enum({
     PRECONDITION_FAILED: "https://api.aventure.vc/errors/precondition-failed",
     PRECONDITION_REQUIRED: "https://api.aventure.vc/errors/precondition-required",
     BILLING_ALLOWANCE_EXHAUSTED: "https://api.aventure.vc/errors/billing-allowance-exhausted",
+    BILLING_ADDITIONAL_USAGE_CAP_REACHED: "https://api.aventure.vc/errors/billing-additional-usage-cap-reached",
     SUBSCRIPTION_REQUIRED: "https://api.aventure.vc/errors/subscription-required",
     SERVICE_UNAVAILABLE: "https://api.aventure.vc/errors/service-unavailable",
     MALFORMED_FORM_BODY: "https://api.aventure.vc/errors/malformed-form-body",

package/dist/publication/facet.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+declare const PublicationFacetSchemaDefinition: z.ZodObject<{
+    contentType: z.ZodEnum<{
+        blogPost: "blogPost";
+        externalSocialPost: "externalSocialPost";
+        newsArticle: "newsArticle";
+        repository: "repository";
+        repositoryOwner: "repositoryOwner";
+        researchPaper: "researchPaper";
+        webPage: "webPage";
+        webSite: "webSite";
+    }>;
+    count: z.ZodNumber;
+    topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type PublicationFacetDefinition = z.infer<typeof PublicationFacetSchemaDefinition>;
+/**
+ * Number of content cards sharing one topic and content type in an owner's index.
+ *
+ * @openapiSchema PublicationFacet
+ * @endpoint GET /v1/entities/{entityId}/content/facets
+ * @endpoint GET /v1/people/{personId}/content/facets
+ * @contractShape publication.facet
+ * @contractRole canonical
+ */
+export declare const PublicationFacetSchema: z.ZodType<PublicationFacetDefinition>;
+export type PublicationFacet = z.infer<typeof PublicationFacetSchema>;
+export {};
+//# sourceMappingURL=facet.d.ts.map

package/dist/publication/facet.js

@@ -0,0 +1,22 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { PublicationTypeSchema } from "./type.js";
+const PublicationFacetSchemaDefinition = z.object({
+    /** Public content source type. */
+    contentType: PublicationTypeSchema,
+    /** Content cards with this topic and content type. */
+    count: z.number().int(),
+    /** Topic key; null when the content carries no topic. */
+    topic: z.string().nullish(),
+});
+/**
+ * Number of content cards sharing one topic and content type in an owner's index.
+ *
+ * @openapiSchema PublicationFacet
+ * @endpoint GET /v1/entities/{entityId}/content/facets
+ * @endpoint GET /v1/people/{personId}/content/facets
+ * @contractShape publication.facet
+ * @contractRole canonical
+ */
+export const PublicationFacetSchema = PublicationFacetSchemaDefinition;
+//# sourceMappingURL=facet.js.map

package/dist/publication/publication.d.ts

@@ -39,7 +39,6 @@ type PublicationDefinition = z.infer<typeof PublicationSchemaDefinition>;
  * @endpoint POST /v1/entities/{entityId}/content/search
  * @endpoint POST /v1/people/{personId}/content/search
  * @usedBySchema PagePublicationSchema
- * @usedBySchema PageResultPublicationSchema
  * @contractShape publication.publication
  * @contractRole canonical
  */

package/dist/publication/publication.js

@@ -23,7 +23,7 @@ const PublicationSchemaDefinition = z.object({
     summary: z.string().nullish(),
     /** Human title or best available display label. webPage rows restate the page URL when the crawl captured no label; renderers may humanize that fallback. */
     title: z.string(),
-    /** Single canonical topic key (web-crawl section vocabulary) or source category (repository language); null when the source has no classified topic. */
+    /** Single canonical topic key (web-crawl section or news-event topic) or source category (repository language); null when the source has no classified topic. */
     topic: z.string().nullish(),
     /** Publication row update instant when known. */
     updatedAt: z.iso.datetime({ offset: true }).nullish(),
@@ -43,7 +43,6 @@ const PublicationSchemaDefinition = z.object({
  * @endpoint POST /v1/entities/{entityId}/content/search
  * @endpoint POST /v1/people/{personId}/content/search
  * @usedBySchema PagePublicationSchema
- * @usedBySchema PageResultPublicationSchema
  * @contractShape publication.publication
  * @contractRole canonical
  */

package/dist/publication/relation.d.ts

@@ -9,7 +9,6 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/content/search
  * @endpoint POST /v1/entities/{entityId}/content/search
  * @endpoint POST /v1/people/{personId}/content/search
- * @usedBySchema PublicationFilterSchema
  * @usedBySchema PublicationSchema
  * @contractShape publication.relation
  * @contractRole canonical

package/dist/publication/relation.js

@@ -10,7 +10,6 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/content/search
  * @endpoint POST /v1/entities/{entityId}/content/search
  * @endpoint POST /v1/people/{personId}/content/search
- * @usedBySchema PublicationFilterSchema
  * @usedBySchema PublicationSchema
  * @contractShape publication.relation
  * @contractRole canonical

package/dist/publication/type.d.ts

@@ -5,11 +5,13 @@ import { z } from "zod/v4";
  * @openapiSchema PublicationType
  * @endpoint GET /v1/content
  * @endpoint GET /v1/entities/{entityId}/content
+ * @endpoint GET /v1/entities/{entityId}/content/facets
  * @endpoint GET /v1/people/{personId}/content
+ * @endpoint GET /v1/people/{personId}/content/facets
  * @endpoint POST /v1/content/search
  * @endpoint POST /v1/entities/{entityId}/content/search
  * @endpoint POST /v1/people/{personId}/content/search
- * @usedBySchema PublicationFilterSchema
+ * @usedBySchema PublicationFacetSchema
  * @usedBySchema PublicationSchema
  * @contractShape publication.type
  * @contractRole canonical

package/dist/publication/type.js

@@ -6,11 +6,13 @@ import { z } from "zod/v4";
  * @openapiSchema PublicationType
  * @endpoint GET /v1/content
  * @endpoint GET /v1/entities/{entityId}/content
+ * @endpoint GET /v1/entities/{entityId}/content/facets
  * @endpoint GET /v1/people/{personId}/content
+ * @endpoint GET /v1/people/{personId}/content/facets
  * @endpoint POST /v1/content/search
  * @endpoint POST /v1/entities/{entityId}/content/search
  * @endpoint POST /v1/people/{personId}/content/search
- * @usedBySchema PublicationFilterSchema
+ * @usedBySchema PublicationFacetSchema
  * @usedBySchema PublicationSchema
  * @contractShape publication.type
  * @contractRole canonical

package/dist/relationship/direction.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * How entities relationships join interprets sourceEntityId and targetEntityId.
+ * How entities relationships create interprets sourceEntityId and targetEntityId.
  *
  * @openapiSchema RelationshipDirection
  * @endpoint GET /v1/entities/relationships/types

package/dist/relationship/direction.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";
 /**
- * How entities relationships join interprets sourceEntityId and targetEntityId.
+ * How entities relationships create interprets sourceEntityId and targetEntityId.
  *
  * @openapiSchema RelationshipDirection
  * @endpoint GET /v1/entities/relationships/types

package/dist/research/allowance-usage.d.ts

@@ -0,0 +1,81 @@
+import { z } from "zod/v4";
+declare const ResearchAllowanceUsageSchemaDefinition: z.ZodObject<{
+    entityView: z.ZodType<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown>>;
+    newCompany: z.ZodType<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown>>;
+    newPerson: z.ZodType<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown>>;
+    personView: z.ZodType<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown>>;
+    update: z.ZodType<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown>>;
+    updatePerson: z.ZodType<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        limit?: number | null | undefined;
+        remaining?: number | null | undefined;
+        resetAt: string;
+        used: number;
+    }, unknown>>;
+}, z.core.$strip>;
+type ResearchAllowanceUsageDefinition = z.infer<typeof ResearchAllowanceUsageSchemaDefinition>;
+/**
+ * @openapiSchema ResearchAllowanceUsage
+ * @endpoint GET /v1/billing/subscription
+ * @usedBySchema BillingSubscriptionSchema
+ * @contractShape research.allowance-usage
+ * @contractRole canonical
+ */
+export declare const ResearchAllowanceUsageSchema: z.ZodType<ResearchAllowanceUsageDefinition>;
+export type ResearchAllowanceUsage = z.infer<typeof ResearchAllowanceUsageSchema>;
+export {};
+//# sourceMappingURL=allowance-usage.d.ts.map

package/dist/research/allowance-usage.js

@@ -0,0 +1,20 @@
+// 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 { ResearchAllowanceSchema } from "./allowance.js";
+const ResearchAllowanceUsageSchemaDefinition = z.object({
+    entityView: ResearchAllowanceSchema,
+    newCompany: ResearchAllowanceSchema,
+    newPerson: ResearchAllowanceSchema,
+    personView: ResearchAllowanceSchema,
+    update: ResearchAllowanceSchema,
+    updatePerson: ResearchAllowanceSchema,
+});
+/**
+ * @openapiSchema ResearchAllowanceUsage
+ * @endpoint GET /v1/billing/subscription
+ * @usedBySchema BillingSubscriptionSchema
+ * @contractShape research.allowance-usage
+ * @contractRole canonical
+ */
+export const ResearchAllowanceUsageSchema = ResearchAllowanceUsageSchemaDefinition;
+//# sourceMappingURL=allowance-usage.js.map

package/dist/research/allowance.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+declare const ResearchAllowanceSchemaDefinition: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    remaining: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    resetAt: z.ZodISODateTime;
+    used: z.ZodInt;
+}, z.core.$strip>;
+type ResearchAllowanceDefinition = z.infer<typeof ResearchAllowanceSchemaDefinition>;
+/**
+ * @openapiSchema ResearchAllowance
+ * @endpoint GET /v1/billing/ai-credits
+ * @endpoint GET /v1/billing/subscription
+ * @usedBySchema ResearchAllowanceUsageSchema
+ * @contractShape research.allowance
+ * @contractRole canonical
+ */
+export declare const ResearchAllowanceSchema: z.ZodType<ResearchAllowanceDefinition>;
+export type ResearchAllowance = z.infer<typeof ResearchAllowanceSchema>;
+export {};
+//# sourceMappingURL=allowance.d.ts.map

package/dist/research/allowance.js

@@ -0,0 +1,20 @@
+// 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 ResearchAllowanceSchemaDefinition = z.object({
+    /** Cap for the period; absent when the tier meters without a cap */
+    limit: z.int().nullish(),
+    /** Cap minus used, never negative; absent when there is no cap */
+    remaining: z.int().nullish(),
+    resetAt: z.iso.datetime({ offset: true }),
+    used: z.int(),
+});
+/**
+ * @openapiSchema ResearchAllowance
+ * @endpoint GET /v1/billing/ai-credits
+ * @endpoint GET /v1/billing/subscription
+ * @usedBySchema ResearchAllowanceUsageSchema
+ * @contractShape research.allowance
+ * @contractRole canonical
+ */
+export const ResearchAllowanceSchema = ResearchAllowanceSchemaDefinition;
+//# sourceMappingURL=allowance.js.map

package/dist/research/derived-bucket.d.ts

@@ -3,9 +3,6 @@ import { z } from "zod/v4";
  * Bucket computed from now() to the target date with inclusive boundaries at 0, 3, 6, 12, and 24 months
  *
  * @openapiSchema ResearchDerivedBucket
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -13,16 +10,15 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/products/suggestions
  * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
  * @endpoint GET /v1/entities/{entityId}/research
- * @endpoint GET /v1/entities/{entityId}/research/details
- * @endpoint GET /v1/entities/{entityId}/research/details/{detailId}
+ * @endpoint GET /v1/entities/{entityId}/research-details
+ * @endpoint GET /v1/entities/{entityId}/research-details/{detailId}
  * @endpoint GET /v1/entities/{entityId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema ResearchDerivedRangeSchema
  * @contractShape research.derived-bucket
  * @contractRole canonical

package/dist/research/derived-bucket.js

@@ -4,9 +4,6 @@ import { z } from "zod/v4";
  * Bucket computed from now() to the target date with inclusive boundaries at 0, 3, 6, 12, and 24 months
  *
  * @openapiSchema ResearchDerivedBucket
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -14,16 +11,15 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/products/suggestions
  * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
  * @endpoint GET /v1/entities/{entityId}/research
- * @endpoint GET /v1/entities/{entityId}/research/details
- * @endpoint GET /v1/entities/{entityId}/research/details/{detailId}
+ * @endpoint GET /v1/entities/{entityId}/research-details
+ * @endpoint GET /v1/entities/{entityId}/research-details/{detailId}
  * @endpoint GET /v1/entities/{entityId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema ResearchDerivedRangeSchema
  * @contractShape research.derived-bucket
  * @contractRole canonical

package/dist/research/derived-range.d.ts

@@ -3,9 +3,6 @@ import { z } from "zod/v4";
  * Read-only derived range projection for targetDateAbsolute detail rows
  *
  * @openapiSchema ResearchDerivedRange
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -13,16 +10,15 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/products/suggestions
  * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
  * @endpoint GET /v1/entities/{entityId}/research
- * @endpoint GET /v1/entities/{entityId}/research/details
- * @endpoint GET /v1/entities/{entityId}/research/details/{detailId}
+ * @endpoint GET /v1/entities/{entityId}/research-details
+ * @endpoint GET /v1/entities/{entityId}/research-details/{detailId}
  * @endpoint GET /v1/entities/{entityId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema EntityResearchDetailSchema
  * @contractShape research.derived-range
  * @contractRole canonical

package/dist/research/derived-range.js

@@ -5,9 +5,6 @@ import { ResearchDerivedBucketSchema } from "./derived-bucket.js";
  * Read-only derived range projection for targetDateAbsolute detail rows
  *
  * @openapiSchema ResearchDerivedRange
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -15,16 +12,15 @@ import { ResearchDerivedBucketSchema } from "./derived-bucket.js";
  * @endpoint GET /v1/entities/{entityId}/products/suggestions
  * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
  * @endpoint GET /v1/entities/{entityId}/research
- * @endpoint GET /v1/entities/{entityId}/research/details
- * @endpoint GET /v1/entities/{entityId}/research/details/{detailId}
+ * @endpoint GET /v1/entities/{entityId}/research-details
+ * @endpoint GET /v1/entities/{entityId}/research-details/{detailId}
  * @endpoint GET /v1/entities/{entityId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema EntityResearchDetailSchema
  * @contractShape research.derived-range
  * @contractRole canonical

package/dist/resolved/handle.d.ts

@@ -15,9 +15,10 @@ declare const ResolvedHandleSchemaDefinition: z.ZodObject<{
 }, z.core.$strip>;
 type ResolvedHandleDefinition = z.infer<typeof ResolvedHandleSchemaDefinition>;
 /**
- * Canonical subject a universal-lookup token resolved to. Exactly one of owner.entityId / owner.personId is set. Echoes the subject's canonical public handle and slug. Fetch display fields with GET /v1/entities/detail or GET /v1/people/detail.
+ * Canonical subject a universal-lookup token resolved to. Exactly one of owner.entityId / owner.personId is set. Echoes the subject's canonical public handle and slug. Fetch display fields with GET /v1/entities/{entityId} or GET /v1/people/{personId}.
  *
  * @openapiSchema ResolvedHandle
+ * @endpoint GET /v1/lookup
  * @endpoint GET /v1/resolve/{token}
  * @contractShape resolved.handle
  * @contractRole canonical

package/dist/resolved/handle.js

@@ -16,9 +16,10 @@ const ResolvedHandleSchemaDefinition = z.object({
         .nullish(),
 });
 /**
- * Canonical subject a universal-lookup token resolved to. Exactly one of owner.entityId / owner.personId is set. Echoes the subject's canonical public handle and slug. Fetch display fields with GET /v1/entities/detail or GET /v1/people/detail.
+ * Canonical subject a universal-lookup token resolved to. Exactly one of owner.entityId / owner.personId is set. Echoes the subject's canonical public handle and slug. Fetch display fields with GET /v1/entities/{entityId} or GET /v1/people/{personId}.
  *
  * @openapiSchema ResolvedHandle
+ * @endpoint GET /v1/lookup
  * @endpoint GET /v1/resolve/{token}
  * @contractShape resolved.handle
  * @contractRole canonical

package/dist/round/label.d.ts

@@ -3,13 +3,8 @@ import { z } from "zod/v4";
  * Round participation label - shared by entity and person investor participation
  *
  * @openapiSchema RoundLabel
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
  * @endpoint GET /v1/entities/summary
- * @endpoint GET /v1/people/detail
- * @endpoint GET /v1/people/detail/investments
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -22,16 +17,14 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/people/{personId}
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
+ * @endpoint GET /v1/people/{personId}/investments
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema EntityInvestorParticipationSchema
  * @usedBySchema FundraiseInvestmentAttributionSchema
  * @usedBySchema PersonInvestorParticipationSchema