@aventurevc/api-schemas 0.8.375 → 0.8.376

package/dist/investor/portfolio-recipient.js

@@ -7,7 +7,7 @@ const InvestorPortfolioRecipientSchemaDefinition = z.object({
     funding: EntityFundingDetailSchema,
 });
 /**
- * Recipient identity with canonical recorded funding coverage.
+ * A portfolio recipient and the funding aVenture has recorded for it.
  *
  * @openapiSchema InvestorPortfolioRecipient
  * @endpoint GET /v1/entities/lookup-exact

package/dist/lookup/job.js

@@ -19,7 +19,7 @@ const LookupJobSchemaDefinition = z.object({
     jobId: z.uuid(),
     /** True when a bulk lookup returned its name bound; more names may remain. False does not prove that extraction found every name on a page. */
     limitReached: z.boolean(),
-    /** Bulk lookup name bound; absent for legacy article jobs. */
+    /** Most names a bulk lookup accepts; absent for older article jobs. */
     maxNames: z.int().nullish(),
     /** Each identified company and person; bulk results are available while running. */
     mention: z.array(LookupJobMentionSchema),
@@ -31,7 +31,7 @@ const LookupJobSchemaDefinition = z.object({
     news: NewsSchema.nullish(),
     /** The article the job reads or names supplied for a bulk lookup. */
     source: LookupJobMutationSchema,
-    /** Source-reading activity for a durably accepted shared article, post, or profile lookup. */
+    /** Reading progress for an accepted, stored lookup of a shared article, post, or profile. */
     sourceRead: LookupSourceReadSchema.nullish(),
     /** Current job state. */
     state: JobStateSchema,

package/dist/lookup/source-read.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Source context and honest reading activity for a shared article, post, profile, or the caller's own captured document.
+ * The shared article, post, or profile, or the caller's own captured document, being read, and what the server is doing with it now.
  *
  * @openapiSchema LookupSourceRead
  * @endpoint GET /v1/lookup/jobs/{jobId}

package/dist/lookup/source-read.js

@@ -4,7 +4,7 @@ import { JobEnqueueSchema } from "../job/enqueue.js";
 import { LookupSourceKindSchema } from "./source-kind.js";
 import { LookupSourceReadPhaseSchema } from "./source-read-phase.js";
 /**
- * Source context and honest reading activity for a shared article, post, profile, or the caller's own captured document.
+ * The shared article, post, or profile, or the caller's own captured document, being read, and what the server is doing with it now.
  *
  * @openapiSchema LookupSourceRead
  * @endpoint GET /v1/lookup/jobs/{jobId}
@@ -18,7 +18,7 @@ export const LookupSourceReadSchema = z.object({
     /** A committed durable lookup to follow; only its presence permits a promise to leave and return. Follow its status URL with the same caller's bearer, honoring Retry-After. */
     continuation: JobEnqueueSchema.nullish(),
     faviconUrl: z.string().nullish(),
-    /** What the source is, so a client names it while it loads; absent only on a lookup an earlier revision accepted. */
+    /** What the source is, so a client names it while it loads; absent only on lookups accepted before this field existed. */
     kind: LookupSourceKindSchema.nullish(),
     logoUrl: z.string().nullish(),
     /** Informational messages to cycle within this stage, never evidence of completed work. */

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

@@ -6064,7 +6064,7 @@ type NaturalSearchResultDefinition = z.infer<typeof NaturalSearchResultSchemaDef
 export interface NaturalSearchResultSchemaInput extends z.input<typeof NaturalSearchResultSchemaDefinition> {
 }
 /**
- * Natural-language entity search result: planner interpretation plus the canonical entity list page produced by EntityListService.
+ * Result of a plain-English entity search: how the query was interpreted, and the resulting page of entities.
  *
  * @openapiSchema NaturalSearchResult
  * @endpoint GET /v1/search/link

package/dist/natural/search-result.js

@@ -28,9 +28,9 @@ const NaturalSearchResultSchemaDefinition = z.object({
     peer: z.array(EntitySimilarityResultSchema),
     /** Web searches for this question not yet stored; their evidence joins a later request. Empty without the `web` layer. */
     pendingWebQuery: z.array(z.string()),
-    /** Whether people lead this search, stamped only on entity stream events. */
+    /** Whether this search is mainly about people; set only on entity events in the stream. */
     personLead: z.boolean(),
-    /** Entity list page returned by the canonical entity list engine. */
+    /** Page of matching entities. */
     result: PageResultEntityListSchema,
     /** Id of this search's stored record. Null when the search was not recorded. */
     searchRequestId: z.uuid().nullish(),
@@ -38,7 +38,7 @@ const NaturalSearchResultSchemaDefinition = z.object({
     subject: z.array(EntityListSchema),
 });
 /**
- * Natural-language entity search result: planner interpretation plus the canonical entity list page produced by EntityListService.
+ * Result of a plain-English entity search: how the query was interpreted, and the resulting page of entities.
  *
  * @openapiSchema NaturalSearchResult
  * @endpoint GET /v1/search/link

package/dist/natural/search.d.ts

@@ -54,7 +54,7 @@ type NaturalSearchDefinition = z.infer<typeof NaturalSearchSchemaDefinition>;
 export interface NaturalSearchSchemaInput extends z.input<typeof NaturalSearchSchemaDefinition> {
 }
 /**
- * Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.
+ * Plain-English search request. The server turns the query into a filter and sort for the target record type, then runs that type's standard list search.
  *
  * @openapiSchema NaturalSearch
  * @endpoint POST /v1/content/search

package/dist/natural/search.js

@@ -27,7 +27,7 @@ const NaturalSearchSchemaDefinition = z.object({
     tenantPolicyRevision: 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.
+ * Plain-English search request. The server turns the query into a filter and sort for the target record type, then runs that type's standard list search.
  *
  * @openapiSchema NaturalSearch
  * @endpoint POST /v1/content/search

package/dist/news/analysis.js

@@ -12,7 +12,7 @@ import { NewsAnalysisSectionSchema } from "./analysis-section.js";
  * @contractRole canonical
  */
 export const NewsAnalysisSchema = z.object({
-    /** Type-safe identifier for news articles */
+    /** Identifier of a news article */
     newsId: z.int(),
     publishedAt: z.iso.datetime({ offset: true }),
     section: z.array(NewsAnalysisSectionSchema),

package/dist/news/detail.d.ts

@@ -135,7 +135,7 @@ type NewsDetailDefinition = z.infer<typeof NewsDetailSchemaDefinition>;
 export interface NewsDetailSchemaInput extends z.input<typeof NewsDetailSchemaDefinition> {
 }
 /**
- * Canonical news detail owner
+ * A news article with all of its detail fields.
  *
  * @openapiSchema NewsDetail
  * @endpoint GET /v1/news/lookup

package/dist/news/detail.js

@@ -19,7 +19,7 @@ const NewsDetailSchemaDefinition = z.object({
     personMentionResolved: z.array(NewsResolvedPersonLinkSchema),
 });
 /**
- * Canonical news detail owner
+ * A news article with all of its detail fields.
  *
  * @openapiSchema NewsDetail
  * @endpoint GET /v1/news/lookup

package/dist/news/news.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical news owner for list and core semantics
+ * A news article, as returned by news lists and the entity.news.published webhook.
  *
  * @openapiSchema News
  * @endpoint GET /v1/entities/lookup-exact

package/dist/news/news.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { NewsTitleMentionSchema } from "./title-mention.js";
 /**
- * Canonical news owner for list and core semantics
+ * A news article, as returned by news lists and the entity.news.published webhook.
  *
  * @openapiSchema News
  * @endpoint GET /v1/entities/lookup-exact
@@ -46,14 +46,14 @@ export const NewsSchema = z.object({
     /** Article summary from the source publication feed; null means the feed supplied no description (expected absence, not an error) — full text is NewsDetail.content */
     excerpt: z.string().nullish(),
     externalNewsArticle: z.boolean().nullish(),
-    /** Type-safe identifier for news articles */
+    /** Identifier of a news article */
     id: z.int(),
     newsImageThumbnail: z.string().nullish(),
     /** Canonical article URL after host and tracking-parameter normalization. */
     newsUrlOriginal: z.string().nullish(),
     publication: z.string().nullish(),
     publishedAt: z.iso.datetime({ offset: true }).nullish(),
-    /** Canonical lowercase URL slug for the resource */
+    /** Lowercase URL slug that identifies the record. */
     slug: z
         .string()
         .regex(/^[a-z0-9_-]+$/)

package/dist/news/resolved-entity-link.js

@@ -37,14 +37,14 @@ import { NewsMatchStatusSchema } from "./match-status.js";
  */
 export const NewsResolvedEntityLinkSchema = z.object({
     createdAt: z.iso.datetime({ offset: true }),
-    /** Canonical entity UUID */
+    /** Entity id (UUID) */
     entityId: z.uuid(),
     href: z.string().nullish(),
     /** True when href links to this entity's aVenture page; false when the entity has no page to link to. */
     internal: z.boolean(),
     matchStatus: NewsMatchStatusSchema.nullish(),
     mention: z.string().nullish(),
-    /** Canonical lowercase URL slug for the resource */
+    /** Lowercase URL slug that identifies the record. */
     slug: z
         .string()
         .regex(/^[a-z0-9_-]+$/)

package/dist/news/resolved-person-link.js

@@ -38,9 +38,9 @@ export const NewsResolvedPersonLinkSchema = z.object({
     href: z.string().nullish(),
     matchStatus: NewsMatchStatusSchema.nullish(),
     mention: z.string().nullish(),
-    /** Canonical person UUID */
+    /** Person id (UUID) */
     personId: z.uuid(),
-    /** Canonical lowercase URL slug for the resource */
+    /** Lowercase URL slug that identifies the record. */
     slug: z
         .string()
         .regex(/^[a-z0-9_-]+$/)

package/dist/news/source-url-conflict.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { DomainConflictTypeSchema } from "../domain/conflict-type.js";
 const NewsSourceUrlConflictSchemaDefinition = z.object({
-    /** Existing article id (NewsId.value) that already owns this publication + URL pair. */
+    /** Id of the existing article that already has this publication and URL. */
     conflictingArticleId: z.int(),
     /** Existing article slug, or empty string when the existing article has no slug. Use with GET /v1/news/lookup?slug= to fetch the conflicting article. */
     conflictingArticleSlug: z.string(),

package/dist/person/detail.d.ts

@@ -2395,7 +2395,7 @@ type PersonDetailDefinition = z.infer<typeof PersonDetailSchemaDefinition>;
 export interface PersonDetailSchemaInput extends z.input<typeof PersonDetailSchemaDefinition> {
 }
 /**
- * Composed person wrapper: core identity + enrichment + associations + investments. Access core fields via .core (for example .core.slug or .core.nameFull).
+ * Full person detail: core identity, additional data, associations, and investments. Core fields are under core (for example .core.slug or .core.nameFull).
  *
  * @openapiSchema PersonDetail
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/detail.js

@@ -32,7 +32,7 @@ const PersonDetailSchemaDefinition = z.object({
     similar: z.array(PersonSimilarityResultSchema).nullish(),
 });
 /**
- * Composed person wrapper: core identity + enrichment + associations + investments. Access core fields via .core (for example .core.slug or .core.nameFull).
+ * Full person detail: core identity, additional data, associations, and investments. Core fields are under core (for example .core.slug or .core.nameFull).
  *
  * @openapiSchema PersonDetail
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/filter.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical person criteria contract for GET/POST/batch endpoints
+ * Filters for listing and searching people, used by the GET, POST, and batch people endpoints.
  *
  * @openapiSchema PersonFilter
  * @endpoint GET /v1/search/link

package/dist/person/filter.js

@@ -6,7 +6,7 @@ import { InvestorActivityFilterSchema } from "../investor/activity-filter.js";
 import { PersonAssociationTenureSchema } from "./association-tenure.js";
 import { PersonListArrayFilterSchema } from "./list-array-filter.js";
 /**
- * Canonical person criteria contract for GET/POST/batch endpoints
+ * Filters for listing and searching people, used by the GET, POST, and batch people endpoints.
  *
  * @openapiSchema PersonFilter
  * @endpoint GET /v1/search/link

package/dist/person/graph-career-context.js

@@ -11,13 +11,13 @@ const PersonGraphCareerContextSchemaDefinition = z.object({
     colleague: z.array(PersonGraphMemberSchema),
     /** Most recent employee-count research fact when one is recorded */
     employeeCount: EmployeeCountSchema.nullish(),
-    /** Entity card projection: core identity plus aggregate funding rollup */
+    /** Entity card: core identity plus total funding */
     entity: EntityFundraiseTransactionEntitySchema,
     /** Primary address of the entity when one is recorded */
     primaryAddress: AddressSchema.nullish(),
     /** Most recent news linked to the entity, newest first */
     recentNews: z.array(NewsSchema),
-    /** Entities similar to this entity, from the entity similarity rails */
+    /** Entities similar to this entity, from aVenture's similar-entity lists */
     similarEntity: z.array(PersonGraphSimilarEntitySchema),
 });
 /**

package/dist/person/graph-co-investor.js

@@ -5,11 +5,11 @@ import { PersonGraphMemberSchema } from "./graph-member.js";
 const PersonGraphCoInvestorSchemaDefinition = z.object({
     /** Number of shared fundraise transactions between the two people */
     overlapCount: z.int(),
-    /** Co-investing person rail member */
+    /** The co-investor's person card */
     person: PersonGraphMemberSchema,
     /** Round label of the shared fundraise transaction */
     round: z.string().nullish(),
-    /** Entity whose fundraise both people participated in (association projection) */
+    /** Entity whose funding round both people participated in */
     sharedEntity: EntitySchema.nullish(),
     /** Shared fundraise transaction id */
     transactionId: z.uuid().nullish(),

package/dist/person/graph-member.d.ts

@@ -29,7 +29,7 @@ type PersonGraphMemberDefinition = z.infer<typeof PersonGraphMemberSchemaDefinit
 export interface PersonGraphMemberSchemaInput extends z.input<typeof PersonGraphMemberSchemaDefinition> {
 }
 /**
- * Lean person rail member with association title facts
+ * Short person card with the person's title at the entity
  *
  * @openapiSchema PersonGraphMember
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/graph-member.js

@@ -5,20 +5,20 @@ const PersonGraphMemberSchemaDefinition = z.object({
     isCurrent: z.boolean().nullish(),
     /** Associated person id */
     personId: z.uuid(),
-    /** Person image projection */
+    /** The person's image fields. */
     personImage: PersonImageSchema,
     /** Person display name */
     personName: z.string(),
-    /** Canonical lowercase URL slug for the resource */
+    /** Lowercase URL slug that identifies the record. */
     personSlug: z
         .string()
         .regex(/^[a-z0-9_-]+$/)
         .max(255),
-    /** Read-side corporate title text for the association row */
+    /** Job title text for this role (read-only). */
     titleName: z.string().nullish(),
 });
 /**
- * Lean person rail member with association title facts
+ * Short person card with the person's title at the entity
  *
  * @openapiSchema PersonGraphMember
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/graph-similar-entity.js

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 import { EntityFundraiseTransactionEntitySchema } from "../entity/fundraise-transaction-entity.js";
 import { PersonGraphMemberSchema } from "./graph-member.js";
 const PersonGraphSimilarEntitySchemaDefinition = z.object({
-    /** Entity card projection: core identity plus aggregate funding rollup */
+    /** Entity card: core identity plus total funding */
     entity: EntityFundraiseTransactionEntitySchema,
     /** Top-ranked current people at the similar entity */
     keyPerson: z.array(PersonGraphMemberSchema),

package/dist/person/graph.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Precomputed professional-graph document for one person: career context per associated entity (entity facts, recent news, colleagues, similar entities with key people), plus co-investors. Lists are capped and pre-ranked server-side; the response is the display order. Served from a precomputed store with member names, images, and slugs hydrated from live person records at read time; computedAt is null only when the document has not been materialized yet.
+ * Precomputed professional-graph document for one person: career context per associated entity (entity facts, recent news, colleagues, similar entities with key people), plus co-investors. Lists are capped and pre-ranked server-side; the response is the display order. The graph is computed ahead of time; member names, images, and slugs are filled in from current person records when you read it. computedAt is null only when the graph has not been computed yet.
  *
  * @openapiSchema PersonGraph
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/graph.js

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 import { PersonGraphCareerContextSchema } from "./graph-career-context.js";
 import { PersonGraphCoInvestorSchema } from "./graph-co-investor.js";
 /**
- * Precomputed professional-graph document for one person: career context per associated entity (entity facts, recent news, colleagues, similar entities with key people), plus co-investors. Lists are capped and pre-ranked server-side; the response is the display order. Served from a precomputed store with member names, images, and slugs hydrated from live person records at read time; computedAt is null only when the document has not been materialized yet.
+ * Precomputed professional-graph document for one person: career context per associated entity (entity facts, recent news, colleagues, similar entities with key people), plus co-investors. Lists are capped and pre-ranked server-side; the response is the display order. The graph is computed ahead of time; member names, images, and slugs are filled in from current person records when you read it. computedAt is null only when the graph has not been computed yet.
  *
  * @openapiSchema PersonGraph
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/image.d.ts

@@ -18,7 +18,7 @@ type PersonImageDefinition = z.infer<typeof PersonImageSchemaDefinition>;
 export interface PersonImageSchemaInput extends z.input<typeof PersonImageSchemaDefinition> {
 }
 /**
- * Read projection: person image fields for detail/list responses
+ * A person's image fields, as returned in detail and list responses.
  *
  * @openapiSchema PersonImage
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/image.js

@@ -9,7 +9,7 @@ const PersonImageSchemaDefinition = z.object({
     pictureVariant: z.array(ImageVariantSchema).nullish(),
 });
 /**
- * Read projection: person image fields for detail/list responses
+ * A person's image fields, as returned in detail and list responses.
  *
  * @openapiSchema PersonImage
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/investment.d.ts

@@ -169,7 +169,7 @@ type PersonInvestmentDefinition = z.infer<typeof PersonInvestmentSchemaDefinitio
 export interface PersonInvestmentSchemaInput extends z.input<typeof PersonInvestmentSchemaDefinition> {
 }
 /**
- * Domain model for a person's investment in an entity (fundraise transaction)
+ * A person's investment in an entity's funding round
  *
  * @openapiSchema PersonInvestment
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/investment.js

@@ -12,7 +12,7 @@ const PersonInvestmentSchemaDefinition = 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)))?)?)?$/)
         .nullish(),
     fundraiseTransaction: EntityFundraiseSchema.nullish(),
-    /** Canonical fundraise transaction UUID */
+    /** Funding round id (UUID) */
     fundraiseTransactionId: z.uuid(),
     id: z.string(),
     /** When aVenture recorded this person's participation in the round. It is not the investment date: imported portfolios share their import date. Use date for when the round happened. */
@@ -22,7 +22,7 @@ const PersonInvestmentSchemaDefinition = z.object({
     round: z.string().nullish(),
 });
 /**
- * Domain model for a person's investment in an entity (fundraise transaction)
+ * A person's investment in an entity's funding round
  *
  * @openapiSchema PersonInvestment
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/lookup-exact-param.js

@@ -13,15 +13,15 @@ export const PERSON_LOOKUP_EXACT_ENDPOINT = "/v1/people/lookup-exact";
  */
 export const PersonLookupExactParamSchema = z.object({
     include: z.array(PersonDetailIncludeSchema).optional(),
-    /** Projection qualifier — include address values (default: true). Set false to omit address array. */
+    /** Include address values in the response (default: true). Set false to omit address array. */
     includeAddress: z.boolean().optional(),
-    /** Projection qualifier — include association values (default: true). Set false to omit association array. */
+    /** Include association values in the response (default: true). Set false to omit association array. */
     includeAssociation: z.boolean().optional(),
-    /** Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array. */
+    /** Include URL link values in the response (default: true). Set false to omit urlLink array. */
     includeUrl: z.boolean().optional(),
     /** Group C — candidate lookup signal: person location (city, state, country). Combine with other group-C signals for bounded search. Mutually exclusive with id and slug; may be combined with url for fallback. */
     location: z.string().optional(),
-    /** Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40. */
+    /** Maximum association values to return; the server caps it at its own association limit. Default: 40. */
     maxAssociations: z.int().optional(),
     /** Group C — candidate lookup signal: loose name match (any of given/family/full). A name alone never resolves; combine it with other group-C signals or url. Mutually exclusive with id and slug. */
     nameAny: z.string().optional(),

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

@@ -1293,7 +1293,7 @@ type PersonNaturalSearchResultDefinition = z.infer<typeof PersonNaturalSearchRes
 export interface PersonNaturalSearchResultSchemaInput extends z.input<typeof PersonNaturalSearchResultSchemaDefinition> {
 }
 /**
- * Natural-language people search result: planner interpretation plus the canonical person page produced by the person list engine.
+ * Result of a plain-English people search: how the query was interpreted, and the resulting page of people.
  *
  * @openapiSchema PersonNaturalSearchResult
  * @endpoint GET /v1/search/link

package/dist/person/natural-search-result.js

@@ -13,13 +13,13 @@ const PersonNaturalSearchResultSchemaDefinition = z.object({
     personLead: z.boolean(),
     /** aVenture people resolved or filed from web-discovered LinkedIn profiles whom no returned person matches, grouped by `named` in query order. A search that has not run yet runs only for a signed-in subscriber with `layer=web`. */
     profile: z.array(SearchPersonProfileSchema),
-    /** Person page returned by the canonical person list engine. */
+    /** Page of matching people. */
     result: PageResultPersonSchema,
     /** Id of this search's stored record. Null when the search was not recorded. */
     searchRequestId: z.uuid().nullish(),
 });
 /**
- * Natural-language people search result: planner interpretation plus the canonical person page produced by the person list engine.
+ * Result of a plain-English people search: how the query was interpreted, and the resulting page of people.
  *
  * @openapiSchema PersonNaturalSearchResult
  * @endpoint GET /v1/search/link

package/dist/person/natural-search.js

@@ -5,7 +5,7 @@ import { PersonFilterSchema } from "./filter.js";
 const PersonNaturalSearchSchemaDefinition = z.object({
     /** Explicit people constraints. Caller-supplied fields override planner values; the planner fills only fields left at their canonical defaults. */
     filter: PersonFilterSchema.optional(),
-    /** Canonical plain-English search request and strategy. */
+    /** The plain-English search request and the search method to use. */
     search: NaturalSearchSchema,
 });
 /**

package/dist/person/person.d.ts

@@ -94,7 +94,7 @@ type PersonDefinition = z.infer<typeof PersonSchemaDefinition>;
 export interface PersonSchemaInput extends z.input<typeof PersonSchemaDefinition> {
 }
 /**
- * Canonical person core record
+ * A person's core profile fields.
  *
  * @openapiSchema Person
  * @endpoint GET /v1/entities/lookup-exact

package/dist/person/person.js

@@ -8,7 +8,7 @@ const PersonSchemaDefinition = z.object({
     /** Record creation timestamp */
     createdAt: z.iso.datetime({ offset: true }).nullish(),
     gender: z.string().nullish(),
-    /** Canonical person UUID */
+    /** Person id (UUID) */
     id: z.uuid(),
     image: PersonImageSchema,
     /** Provenance-grounded last-modified watermark (schema.org dateModified): the latest effective time across all writes attributed to this person. */
@@ -23,14 +23,14 @@ const PersonSchemaDefinition = z.object({
     /** Middle name as stored after name normalization */
     nameMiddle: z.string().nullish(),
     nickname: z.string().nullish(),
-    /** Stable, immutable public handle (e.g. `pV1StGXR8Z5ab`). 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. `pV1StGXR8Z5ab`). 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(/^p[0-9A-Za-z]{12}$/)
         .nullish(),
-    /** Semantic embedding match evidence populated only for semantic people reads. */
+    /** Why this person matched a meaning-based (semantic) search; set only on semantic searches. */
     semanticMatch: ContentEmbeddingMatchSchema.nullish(),
-    /** Canonical lowercase URL slug for the resource */
+    /** Lowercase URL slug that identifies the record. */
     slug: z
         .string()
         .regex(/^[a-z0-9_-]+$/)
@@ -42,7 +42,7 @@ const PersonSchemaDefinition = z.object({
     updatedAt: z.iso.datetime({ offset: true }).nullish(),
 });
 /**
- * Canonical person core record
+ * A person's core profile fields.
  *
  * @openapiSchema Person
  * @endpoint GET /v1/entities/lookup-exact

package/dist/redirect/current-slug-owner.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Current slug owner
+ * Record that currently uses this slug
  *
  * @openapiSchema CurrentSlugOwner
  * @standardProblemResponse

package/dist/redirect/current-slug-owner.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { SlugResourceSchema } from "./slug-resource.js";
 /**
- * Current slug owner
+ * Record that currently uses this slug
  *
  * @openapiSchema CurrentSlugOwner
  * @standardProblemResponse

package/dist/research/allowance-usage.js

@@ -4,7 +4,7 @@ import { ResearchAllowanceSchema } from "./allowance.js";
 const ResearchAllowanceUsageSchemaDefinition = z.object({
     /** Research runs on company targets, new or existing */
     company: ResearchAllowanceSchema,
-    /** Thin company brand reads (names, logos, links, tags) */
+    /** Company brand summary reads (names, logos, links, tags) */
     entityBrand: ResearchAllowanceSchema,
     /** Company profile views; Essential shares included usage with personView, while paid tiers meter each separately */
     entityView: ResearchAllowanceSchema,

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Read-only derived range projection for targetDateAbsolute detail rows
+ * Read-only time range computed for targetDateAbsolute research details
  *
  * @openapiSchema ResearchDerivedRange
  * @endpoint GET /v1/entities/lookup-exact

package/dist/research/derived-range.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { ResearchDerivedBucketSchema } from "./derived-bucket.js";
 /**
- * Read-only derived range projection for targetDateAbsolute detail rows
+ * Read-only time range computed for targetDateAbsolute research details
  *
  * @openapiSchema ResearchDerivedRange
  * @endpoint GET /v1/entities/lookup-exact

package/dist/research/detail-type.js

@@ -19,7 +19,7 @@ const ResearchDetailTypeSchemaDefinition = z.object({
     typeValue: z.string(),
     /** Write-time value shape token. For numericCountOrRange details, send either discreteValue for an exact count or textValue for an employee range. */
     valueShape: ResearchValueShapeTypeSchema,
-    /** Read projection category; choose write fields from valueShape. */
+    /** Value kind on reads; pick write fields from valueShape. */
     valueType: EntityResearchValueTypeSchema,
     /** How to encode a write for this valueShape: which of valueResearchDetail, discreteValue, textValue, and asOfDate to send, with an example. */
     writeHint: z.string(),

package/dist/research/paragraph-shape.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Write-time per-paragraph shape rule for governed text bodies. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence. Each paragraph ends in terminal punctuation (. ! ? or the CJK full stop, exclamation, and question marks), optionally followed by a closing quote, parenthesis, bracket, or guillemet.
+ * Paragraph rules that text must meet when written. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence. Each paragraph ends in terminal punctuation (. ! ? or the CJK full stop, exclamation, and question marks), optionally followed by a closing quote, parenthesis, bracket, or guillemet.
  *
  * @openapiSchema ResearchParagraphShape
  * @endpoint GET /v1/entities/research-snippets/types

package/dist/research/paragraph-shape.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";
 /**
- * Write-time per-paragraph shape rule for governed text bodies. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence. Each paragraph ends in terminal punctuation (. ! ? or the CJK full stop, exclamation, and question marks), optionally followed by a closing quote, parenthesis, bracket, or guillemet.
+ * Paragraph rules that text must meet when written. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence. Each paragraph ends in terminal punctuation (. ! ? or the CJK full stop, exclamation, and question marks), optionally followed by a closing quote, parenthesis, bracket, or guillemet.
  *
  * @openapiSchema ResearchParagraphShape
  * @endpoint GET /v1/entities/research-snippets/types