@aventurevc/api-schemas 0.8.375 → 0.8.377

package/dist/address/address.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical address record for entity and person payloads
+ * A postal address of an entity or person.
  *
  * @openapiSchema Address
  * @endpoint GET /v1/entities/lookup-exact

package/dist/address/address.js

@@ -5,7 +5,7 @@ import { AddressCitySchema } from "./city.js";
 import { AddressCountrySchema } from "./country.js";
 import { AddressStateSchema } from "./state.js";
 /**
- * Canonical address record for entity and person payloads
+ * A postal address of an entity or person.
  *
  * @openapiSchema Address
  * @endpoint GET /v1/entities/lookup-exact

package/dist/agent/task-preset-catalog.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { AgentTaskPresetSchema } from "./task-preset.js";
 const AgentTaskPresetCatalogSchemaDefinition = z.object({
-    /** Available task presets. Field name is singular by repository convention even though the value is a collection. */
+    /** Available task presets. The field name is singular, but it holds a list. */
     taskPreset: z.array(AgentTaskPresetSchema),
 });
 /**

package/dist/agent/task-preset-phase.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Dispatch phase governing intra-job ordering when presets are multi-selected.
+ * Run order when several presets are selected: PRIMARY presets run first; FINAL presets run after them, together, so they read the updated profile.
  *
  * @openapiSchema AgentTaskPresetPhase
  * @endpoint GET /v1/research/runs/presets

package/dist/agent/task-preset-phase.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";
 /**
- * Dispatch phase governing intra-job ordering when presets are multi-selected.
+ * Run order when several presets are selected: PRIMARY presets run first; FINAL presets run after them, together, so they read the updated profile.
  *
  * @openapiSchema AgentTaskPresetPhase
  * @endpoint GET /v1/research/runs/presets

package/dist/agent/task-preset.js

@@ -9,7 +9,7 @@ const AgentTaskPresetSchemaDefinition = z.object({
     key: z.string(),
     /** Display name of the topic the preset researches. */
     name: z.string(),
-    /** Dispatch phase for intra-job ordering: PRIMARY presets run first; FINAL presets defer until the primary wave completes so they read the freshly-updated entity dossier. */
+    /** Run order within one job: PRIMARY presets run first; FINAL presets wait until every PRIMARY preset finishes so they read the freshly updated entity profile. */
     phase: AgentTaskPresetPhaseSchema,
 });
 /**

package/dist/auth/operation-authorization.d.ts

@@ -28,7 +28,7 @@ type AuthOperationAuthorizationDefinition = z.infer<typeof AuthOperationAuthoriz
 export interface AuthOperationAuthorizationSchemaInput extends z.input<typeof AuthOperationAuthorizationSchemaDefinition> {
 }
 /**
- * Current permission grant, access class, and supplied API operations admitted by the live request authorization policy.
+ * Your current permissions, access level, and which of the API operations you listed you may call under the current authorization policy.
  *
  * @openapiSchema AuthOperationAuthorization
  * @endpoint POST /v1/auth/me/permissions

package/dist/auth/operation-authorization.js

@@ -4,7 +4,7 @@ import { AuthOperationAccessSchema } from "./operation-access.js";
 import { AuthOperationSchema } from "./operation.js";
 import { AuthPermissionGrantSchema } from "./permission-grant.js";
 const AuthOperationAuthorizationSchemaDefinition = z.object({
-    /** Supplied operations admitted by the current session. */
+    /** Operations from your list that the current session may call. */
     operation: z.array(AuthOperationSchema),
     /** Highest access class represented by the current session. */
     operationAccess: AuthOperationAccessSchema,
@@ -12,7 +12,7 @@ const AuthOperationAuthorizationSchemaDefinition = z.object({
     permissionGrant: AuthPermissionGrantSchema,
 });
 /**
- * Current permission grant, access class, and supplied API operations admitted by the live request authorization policy.
+ * Your current permissions, access level, and which of the API operations you listed you may call under the current authorization policy.
  *
  * @openapiSchema AuthOperationAuthorization
  * @endpoint POST /v1/auth/me/permissions

package/dist/blog/post-type.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * External research-side blog-post source classification
+ * Where a collected blog post came from
  *
  * @openapiSchema BlogPostType
  * @endpoint GET /v1/entities/lookup-exact

package/dist/blog/post-type.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";
 /**
- * External research-side blog-post source classification
+ * Where a collected blog post came from
  *
  * @openapiSchema BlogPostType
  * @endpoint GET /v1/entities/lookup-exact

package/dist/blog/post.d.ts

@@ -34,7 +34,7 @@ type BlogPostDefinition = z.infer<typeof BlogPostSchemaDefinition>;
 export interface BlogPostSchemaInput extends z.input<typeof BlogPostSchemaDefinition> {
 }
 /**
- * External research-side blog post owned by exactly one entity or person. Unrelated to app.app_blog_article.
+ * A blog post published by exactly one entity or person and collected during research. It is not an aVenture blog article.
  *
  * @openapiSchema BlogPost
  * @endpoint GET /v1/entities/lookup-exact

package/dist/blog/post.js

@@ -8,7 +8,7 @@ const BlogPostSchemaDefinition = z.object({
     createdAt: z.iso.datetime({ offset: true }),
     /** Stable external feed/item identifier when available */
     externalId: z.string().nullish(),
-    /** Type-safe UUID identifier for research-side external blog article links */
+    /** UUID of a link to an external blog article collected during research */
     id: z.uuid(),
     isCurrent: z.boolean(),
     /** Last time ingest fetched or summarized this blog-post URL */
@@ -32,7 +32,7 @@ const BlogPostSchemaDefinition = z.object({
     url: z.string(),
 });
 /**
- * External research-side blog post owned by exactly one entity or person. Unrelated to app.app_blog_article.
+ * A blog post published by exactly one entity or person and collected during research. It is not an aVenture blog article.
  *
  * @openapiSchema BlogPost
  * @endpoint GET /v1/entities/lookup-exact

package/dist/classification/catalog-bucket.js

@@ -6,7 +6,7 @@ const ClassificationCatalogBucketSchemaDefinition = z.object({
     alias: z.array(z.string()),
     /** Canonical classification bucket key. */
     bucket: z.string().nullish(),
-    /** Whether the bucket has hierarchy semantics. */
+    /** Whether the bucket's values form a parent and child hierarchy. */
     hierarchical: z.boolean(),
     /** Human-readable bucket label (e.g. 'Revenue Model'). */
     label: z.string(),

package/dist/classification/catalog-category.js

@@ -10,7 +10,7 @@ const ClassificationCatalogCategorySchemaDefinition = z.object({
     classification: z.array(StandardizedClassificationSchema),
     /** Total standardized classifications in this category. */
     classificationCount: z.int(),
-    /** Whether the category has hierarchy semantics. */
+    /** Whether the category's values form a parent and child hierarchy. */
     hierarchical: z.boolean(),
     /** Human-readable category label. */
     label: z.string(),

package/dist/classification/join-registry.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Entity classification join registry discriminator for paths where editorial and standardized join row ids may collide.
+ * Which kind of entity classification an id belongs to, editorial or standardized; needed on paths where the two kinds can share the same id number.
  *
  * @openapiSchema ClassificationJoinRegistry
  * @endpoint GET /v1/entities/brand

package/dist/classification/join-registry.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 const ClassificationJoinRegistrySchemaKnownMembers = z.enum(["editorial", "standardized"]);
 /**
- * Entity classification join registry discriminator for paths where editorial and standardized join row ids may collide.
+ * Which kind of entity classification an id belongs to, editorial or standardized; needed on paths where the two kinds can share the same id number.
  *
  * @openapiSchema ClassificationJoinRegistry
  * @endpoint GET /v1/entities/brand

package/dist/cli/authorization-poll.js

@@ -10,7 +10,7 @@ const CliAuthorizationPollSchemaDefinition = z.object({
     expiresAt: z.iso.datetime({ offset: true }),
     /** Current broker lifecycle state */
     status: CliAuthorizationStatusSchema,
-    /** Non-secret terminal-state explanation */
+    /** Why the request ended (contains no secrets) */
     terminalReason: CliAuthorizationTerminalReasonSchema.nullish(),
 });
 /**

package/dist/cli/authorization.js

@@ -28,7 +28,7 @@ const CliAuthorizationSchemaDefinition = z.object({
     status: CliAuthorizationStatusSchema,
     /** Time this request entered its terminal state */
     terminalAt: z.iso.datetime({ offset: true }).nullish(),
-    /** Non-secret terminal-state explanation */
+    /** Why the request ended (contains no secrets) */
     terminalReason: CliAuthorizationTerminalReasonSchema.nullish(),
     /** Most recent lifecycle update timestamp */
     updatedAt: z.iso.datetime({ offset: true }),

package/dist/content/compliance.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Derived character/word counts and whether the row text meets its governed type contract (word/character limits and paragraph shape). violation lists each unmet rule and is empty when the row is compliant.
+ * Character and word counts for the text, and whether it meets its text type's rules (word and character limits and paragraph shape). violation lists each unmet rule and is empty when the text meets them all.
  *
  * @openapiSchema ContentCompliance
  * @endpoint GET /v1/entities/lookup-exact

package/dist/content/compliance.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";
 /**
- * Derived character/word counts and whether the row text meets its governed type contract (word/character limits and paragraph shape). violation lists each unmet rule and is empty when the row is compliant.
+ * Character and word counts for the text, and whether it meets its text type's rules (word and character limits and paragraph shape). violation lists each unmet rule and is empty when the text meets them all.
  *
  * @openapiSchema ContentCompliance
  * @endpoint GET /v1/entities/lookup-exact
@@ -30,7 +30,7 @@ import { z } from "zod/v4";
 export const ContentComplianceSchema = z.object({
     /** Character count of the row text (UTF-16 units). */
     characterCount: z.int(),
-    /** Whether the text satisfies every governed contract rule. */
+    /** Whether the text meets every length and paragraph rule for its type. */
     meetsRequirements: z.boolean(),
     /** One human-readable reason per unmet rule; empty when compliant. */
     violation: z.array(z.string()),

package/dist/content/embedding-match.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Nearest-neighbor content embedding match evidence.
+ * Why content matched a meaning-based (semantic) search.
  *
  * @openapiSchema ContentEmbeddingMatch
  * @endpoint GET /v1/entities/lookup-exact

package/dist/content/embedding-match.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { ContentSourceTypeSchema } from "./source-type.js";
 /**
- * Nearest-neighbor content embedding match evidence.
+ * Why content matched a meaning-based (semantic) search.
  *
  * @openapiSchema ContentEmbeddingMatch
  * @endpoint GET /v1/entities/lookup-exact
@@ -44,13 +44,13 @@ export const ContentEmbeddingMatchSchema = z.object({
     cosineScore: z.number(),
     /** Embedding model/profile version for this row. */
     modelVersion: z.string(),
-    /** One-based semantic rank within the returned ANN candidate set. */
+    /** Rank by meaning similarity among the nearest-neighbor candidates returned, starting at 1. */
     rank: z.int(),
     /** SHA-256 hash of the source content. */
     sourceHash: z.string(),
     /** Content embedding source identifier. */
     sourceId: z.string(),
-    /** Stored content embedding source partition. */
+    /** Kind of content that matched. */
     sourceType: ContentSourceTypeSchema,
 });
 //# sourceMappingURL=embedding-match.js.map

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Discriminator for unified content embedding source partitions
+ * Kind of content a similarity match came from; new kinds may be added.
  *
  * @openapiSchema ContentSourceType
  * @endpoint GET /v1/entities/lookup-exact

package/dist/content/source-type.js

@@ -15,7 +15,7 @@ const ContentSourceTypeSchemaKnownMembers = z.enum([
     "sourceDocument",
 ]);
 /**
- * Discriminator for unified content embedding source partitions
+ * Kind of content a similarity match came from; new kinds may be added.
  *
  * @openapiSchema ContentSourceType
  * @endpoint GET /v1/entities/lookup-exact

package/dist/datasource/source-metadata.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Grouped source/provenance metadata for private v1 response fields
+ * Details of where a record's field values came from.
  *
  * @openapiSchema DatasourceSourceMetadata
  * @endpoint GET /v1/search/link

package/dist/datasource/source-metadata.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";
 /**
- * Grouped source/provenance metadata for private v1 response fields
+ * Details of where a record's field values came from.
  *
  * @openapiSchema DatasourceSourceMetadata
  * @endpoint GET /v1/search/link

package/dist/enrichment/batch.js

@@ -4,7 +4,7 @@ import { EnrichmentInstructionSchema } from "./instruction.js";
 import { EnrichmentModeSchema } from "./mode.js";
 import { HarnessRunLaneSchema } from "../harness/run-lane.js";
 const EnrichmentBatchSchemaDefinition = z.object({
-    /** Canonical entity UUIDs to enrich, filed in order before any person */
+    /** Entity ids (UUIDs) to enrich, filed in order before any person */
     entityId: z.array(z.uuid()).optional(),
     /** Additional instructions for selected records, one entry per owner. Each entry appends to the shared userPrompt for that owner only. Duplicate or unselected owners and combined prompts longer than the run limit are rejected before any run is filed. Omit for identical instructions on every run. */
     instruction: z.array(EnrichmentInstructionSchema).optional(),
@@ -16,7 +16,7 @@ const EnrichmentBatchSchemaDefinition = z.object({
     model: z.string().nullish(),
     /** News article ids. The server identifies every company and person each article names, as POST /v1/lookup/mentions does with sourceNewsId, adds the article's linked companies and people, and files one enrichment per distinct record. */
     newsId: z.array(z.int()).optional(),
-    /** Canonical person UUIDs to enrich, filed in order after every entity */
+    /** Person ids (UUIDs) to enrich, filed in order after every entity */
     personId: z.array(z.uuid()).optional(),
     /** Task preset keys that scope or emphasize every run; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400 */
     taskPresetKey: z.array(z.string()).nullish(),

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

@@ -84,7 +84,7 @@ type EntityAcceleratorParticipationDefinition = z.infer<typeof EntityAccelerator
 export interface EntityAcceleratorParticipationSchemaInput extends z.input<typeof EntityAcceleratorParticipationSchemaDefinition> {
 }
 /**
- * Flattened accelerator participation derived from acceleratorParticipant relationship rows and joined to the canonical accelerator entity.
+ * One accelerator program the entity took part in, from its acceleratorParticipant relationship, with the accelerator's own entity record.
  *
  * @openapiSchema EntityAcceleratorParticipation
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/accelerator-participation.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { EntitySchema } from "./entity.js";
 const EntityAcceleratorParticipationSchemaDefinition = z.object({
-    /** Canonical thin accelerator entity from the acceleratorParticipant relationship */
+    /** The accelerator's basic entity record, from the acceleratorParticipant relationship */
     accelerator: EntitySchema,
     /** Full accelerator participation name, including program detail */
     acceleratorName: z.string(),
@@ -12,7 +12,7 @@ const EntityAcceleratorParticipationSchemaDefinition = z.object({
         .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[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$/),
     /** Accelerator batch or cohort */
     batch: z.string().nullish(),
-    /** Stable participation identifier anchored to the contributing acceleratorParticipant relationship */
+    /** Stable id of this participation, tied to the acceleratorParticipant relationship it comes from */
     id: z.string(),
     /** Accelerator program name, when the source distinguishes one */
     program: z.string().nullish(),
@@ -20,7 +20,7 @@ const EntityAcceleratorParticipationSchemaDefinition = z.object({
     status: z.string().nullish(),
 });
 /**
- * Flattened accelerator participation derived from acceleratorParticipant relationship rows and joined to the canonical accelerator entity.
+ * One accelerator program the entity took part in, from its acceleratorParticipant relationship, with the accelerator's own entity record.
  *
  * @openapiSchema EntityAcceleratorParticipation
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/acquisition.js

@@ -7,9 +7,9 @@ import { EntityResearchPublicSourceSchema } from "./research-public-source.js";
 import { FundraiseDataConfidenceSchema } from "../fundraise/data-confidence.js";
 import { FundraiseTransactionStatusSchema } from "../fundraise/transaction-status.js";
 const EntityAcquisitionSchemaDefinition = z.object({
-    /** Acquired company — read-only nested display projection of the scoped path entity. */
+    /** The acquired company (the entity in the request path); read-only. */
     acquiredEntity: EntitySchema,
-    /** Buyer — read-only nested display projection. Mutations identify the buyer only via the flat acquirerEntityId UUID, never a nested entity object. */
+    /** The buyer; read-only. Mutations identify the buyer only via the flat acquirerEntityId UUID, never a nested entity object. */
     acquirerEntity: EntitySchema,
     amount: z.number().int().nullish(),
     /** Acquisition announcement date or instant, retaining its stored precision. */
@@ -31,16 +31,16 @@ const EntityAcquisitionSchemaDefinition = z.object({
     currency: z.string().nullish(),
     dataConfidence: FundraiseDataConfidenceSchema.nullish(),
     evidence: EntityAcquisitionEvidenceSchema,
-    /** Canonical fundraise transaction UUID */
+    /** Funding round id (UUID) */
     fundraiseTransactionId: z.uuid().nullish(),
-    /** Type-safe identifier for fundraise investor joins */
+    /** Identifier of one investor's participation in a funding round */
     investorJoinId: z.uuid().nullish(),
     /** Whether the buyer still owns the acquired company, not whether the company is operating. False retains the prior ownership event on this relationship. */
     isCurrent: z.boolean().nullish(),
     /** Published page behind this acquisition, read from the provenance event that wrote it; absent for internal sources. */
     publicSource: EntityResearchPublicSourceSchema.nullish(),
     relationshipId: z.int(),
-    /** Read stage of the acquired entity, not transactionStatus */
+    /** Acquisition stage of the acquired entity, not the deal's transactionStatus */
     status: EntityAcquisitionStageSchema,
     transactionStatus: FundraiseTransactionStatusSchema.nullish(),
     updatedAt: z.iso.datetime({ offset: true }).nullish(),

package/dist/entity/analysis-replay.js

@@ -11,7 +11,7 @@ const EntityAnalysisReplaySchemaDefinition = z.object({
     entitySlug: z.string(),
     /** Retained legacy field, always empty. Conversation is withheld; publishedSection is a result, not a reply. */
     event: z.array(HarnessRunEventSchema),
-    /** The accepted current visible snippet, with only canonical public source metadata. */
+    /** The accepted, current, visible snippet, with only its public source details. */
     publishedSection: EntityResearchSnippetSchema.nullish(),
     /** The single snippet type displayed by this public example. */
     section: z.array(z.string()),

package/dist/entity/brand.d.ts

@@ -461,7 +461,7 @@ type EntityBrandDefinition = z.infer<typeof EntityBrandSchemaDefinition>;
 export interface EntityBrandSchemaInput extends z.input<typeof EntityBrandSchemaDefinition> {
 }
 /**
- * Thin company brand read: names and logos under core, current website and social URLs, and current classification tags.
+ * Company brand summary: names and logos under core, current website and social URLs, and current classification tags.
  *
  * @openapiSchema EntityBrand
  * @endpoint GET /v1/entities/brand

package/dist/entity/brand.js

@@ -14,7 +14,7 @@ const EntityBrandSchemaDefinition = z.object({
     urlLink: z.array(EntityUrlLinkSchema),
 });
 /**
- * Thin company brand read: names and logos under core, current website and social URLs, and current classification tags.
+ * Company brand summary: names and logos under core, current website and social URLs, and current classification tags.
  *
  * @openapiSchema EntityBrand
  * @endpoint GET /v1/entities/brand

package/dist/entity/comparison-signals.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Competitive comparison signals for a provider entity — sells-to customers, pricing model, ownership, funding stage, total raised, and website. Projected from entity enrichment for side-by-side comparison; founded year rides the entity core.
+ * Competitive comparison signals for a provider entity — sells-to customers, pricing model, ownership, funding stage, total raised, and website. Taken from the entity's additional data for side-by-side comparison; the founding year is in the entity's core fields.
  *
  * @openapiSchema EntityComparisonSignals
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/comparison-signals.js

@@ -4,7 +4,7 @@ import { EntitySchema } from "./entity.js";
 import { EntityProfileStatusSchema } from "./profile-status.js";
 import { FundingStageSchema } from "../funding/stage.js";
 /**
- * Competitive comparison signals for a provider entity — sells-to customers, pricing model, ownership, funding stage, total raised, and website. Projected from entity enrichment for side-by-side comparison; founded year rides the entity core.
+ * Competitive comparison signals for a provider entity — sells-to customers, pricing model, ownership, funding stage, total raised, and website. Taken from the entity's additional data for side-by-side comparison; the founding year is in the entity's core fields.
  *
  * @openapiSchema EntityComparisonSignals
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/detail.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Full entity detail response: core entity, enrichment, governed research, relationships, external identifiers, fundraising, news, people, and sitemap eligibility. Core identity and naming fields live under core.
+ * Full entity detail: core fields, additional data, research, relationships, external identifiers, fundraising, news, people, and which profile pages exist. Identity and name fields are under core.
  *
  * @openapiSchema EntityDetail
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/detail.js

@@ -14,7 +14,7 @@ import { PersonDetailSchema } from "../person/detail.js";
 import { SearchAnswerSchema } from "../search/answer.js";
 import { UniqueIdSchema } from "../unique/id.js";
 /**
- * Full entity detail response: core entity, enrichment, governed research, relationships, external identifiers, fundraising, news, people, and sitemap eligibility. Core identity and naming fields live under core.
+ * Full entity detail: core fields, additional data, research, relationships, external identifiers, fundraising, news, people, and which profile pages exist. Identity and name fields are under core.
  *
  * @openapiSchema EntityDetail
  * @endpoint GET /v1/entities/lookup-exact
@@ -61,9 +61,9 @@ export const EntityDetailSchema = z.object({
     publicUrl: z.string().nullish(),
     /** Entity relationships. */
     relationship: z.array(EntityRelationshipSchema),
-    /** Combined research disclosure: governed detail rows, snippets, and accelerator participation. */
+    /** Research findings: structured research details, written research snippets, and accelerator participation. */
     research: EntityResearchSchema,
-    /** Sub-route eligibility computed once at the persistence boundary. */
+    /** Which of the entity's profile pages exist and are listed in the sitemap. */
     sitemap: EntitySitemapSchema,
     /** External registry identifiers associated with this entity. */
     uniqueId: z.array(UniqueIdSchema),

package/dist/entity/entity.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
+ * Core fields of an entity: identity, names, status, image, and source details. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
  *
  * @openapiSchema Entity
  * @endpoint GET /v1/entities/brand

package/dist/entity/entity.js

@@ -5,7 +5,7 @@ import { EntityNameAliasEntityAliasTypeSchema } from "./name-alias-entity-alias-
 import { EntitySitemapSchema } from "./sitemap.js";
 import { EntityTypeSchema } from "./type.js";
 /**
- * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
+ * Core fields of an entity: identity, names, status, image, and source details. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
  *
  * @openapiSchema Entity
  * @endpoint GET /v1/entities/brand
@@ -84,14 +84,14 @@ export const EntitySchema = z.object({
     nameLegal: z.string().nullish(),
     /** Current operating status. Use Acquired Subsidiary when the entity was acquired and still operates; use Closed (Acquihire) when the entity was acquired for its team and shut down, rendering like Closed everywhere; use Acquired only when it is terminal, folded, or closed. */
     operatingStatus: z.string().nullish(),
-    /** Stable, immutable public handle (e.g. `eV1StGXR8Z5a`). Never changes once assigned, unlike the slug. Null on projections that do not select it and on rows still awaiting handle backfill. */
+    /** Stable, immutable public handle (e.g. `eV1StGXR8Z5a`). Never changes once assigned, unlike the slug. Null on responses that do not include it and on older records not yet given a handle. */
     publicId: z
         .string()
         .regex(/^e[0-9A-Za-z]{11}$/)
         .nullish(),
     /** Absolute public profile URL on the aVenture front-end, e.g. `https://aventure.vc/non-profits/{slug}`, derived from the typeRecord's canonical route family. Null when the route needs relationship context or the record has no direct public SSR route (Business Line, Organization, Product, Service, or a non-public slug). EntityDetail.publicUrl resolves Business Line parent context. A Product/Service has no standalone page: it is addressed only as `{providerPublicUrl}/products-services/{slug}` under its provider, because its slug is unique only per provider; the sitemap-urls slot paths already emit those child routes. */
     publicUrl: z.string().nullish(),
-    /** Sub-route eligibility, populated by the sitemap projection. Null on non-sitemap reads to keep thin payloads compact. */
+    /** Which of the entity's profile pages exist and are listed in the sitemap; set only on sitemap reads and null otherwise to keep responses small. */
     sitemap: EntitySitemapSchema.nullish(),
     /** URL-safe identifier */
     slug: z

package/dist/entity/filter-control-type.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Render control discriminator for filter UI components
+ * Kind of control to draw for this filter
  *
  * @openapiSchema EntityFilterControlType
  * @endpoint GET /v1/entities/filters

package/dist/entity/filter-control-type.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";
 /**
- * Render control discriminator for filter UI components
+ * Kind of control to draw for this filter
  *
  * @openapiSchema EntityFilterControlType
  * @endpoint GET /v1/entities/filters

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * API response fragment for entity filter metadata
+ * Entity filter metadata
  *
  * @openapiSchema EntityFilterMeta
  * @endpoint GET /v1/entities/filters

package/dist/entity/filter-meta.js

@@ -4,7 +4,7 @@ import { EntityFilterRequestBindingSchema } from "./filter-request-binding.js";
 import { EntityFilterUiMetaSchema } from "./filter-ui-meta.js";
 import { EntityTypeSchema } from "./type.js";
 /**
- * API response fragment for entity filter metadata
+ * Entity filter metadata
  *
  * @openapiSchema EntityFilterMeta
  * @endpoint GET /v1/entities/filters
@@ -17,7 +17,7 @@ import { EntityTypeSchema } from "./type.js";
 export const EntityFilterMetaSchema = z.object({
     /** Concrete entity kinds supported by this facet, not a claim that each has recorded values. */
     applicableTypeRecord: z.array(EntityTypeSchema).nullish(),
-    /** Executable binding in the EntityFilter request body; absent on older servers. */
+    /** Where this filter goes in the EntityFilter request body; absent on older servers. */
     requestBinding: EntityFilterRequestBindingSchema.nullish(),
     /** UI metadata for rendering entity filter controls */
     ui: EntityFilterUiMetaSchema.nullish(),

package/dist/entity/filter-option-set-meta.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Generator metadata for a filter payload
+ * Information about how this filter's option list was generated
  *
  * @openapiSchema EntityFilterOptionSetMeta
  * @endpoint GET /v1/entities/filters

package/dist/entity/filter-option-set-meta.js

@@ -4,7 +4,7 @@ import { EntityFilterOptionModeSchema } from "./filter-option-mode.js";
 import { EntityTypeGroupMembershipSchema } from "./type-group-membership.js";
 import { EntityTypeGroupSchema } from "./type-group.js";
 /**
- * Generator metadata for a filter payload
+ * Information about how this filter's option list was generated
  *
  * @openapiSchema EntityFilterOptionSetMeta
  * @endpoint GET /v1/entities/filters

package/dist/entity/filter-request-value-shape.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical request value shape derived from the bound Kotlin property type.
+ * Kind of value this filter property takes in the request body.
  *
  * @openapiSchema EntityFilterRequestValueShape
  * @endpoint GET /v1/entities/filters

package/dist/entity/filter-request-value-shape.js

@@ -7,7 +7,7 @@ const EntityFilterRequestValueShapeSchemaKnownMembers = z.enum([
     "DECIMAL_RANGE_ARRAY",
 ]);
 /**
- * Canonical request value shape derived from the bound Kotlin property type.
+ * Kind of value this filter property takes in the request body.
  *
  * @openapiSchema EntityFilterRequestValueShape
  * @endpoint GET /v1/entities/filters