@aventurevc/api-schemas 0.7.283

package/dist/person/person.d.ts

@@ -0,0 +1,112 @@
+import { z } from "zod/v4";
+declare const PersonSchemaDefinition: z.ZodObject<{
+    createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    gender: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodUUID;
+    image: z.ZodType<{
+        isMonogram: boolean;
+        picture?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        isMonogram: boolean;
+        picture?: string | null | undefined;
+    }, unknown>>;
+    lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    nameAlias: z.ZodArray<z.ZodType<{
+        displayable?: boolean | null | undefined;
+        name: string;
+        type?: "formerName" | "maidenName" | "nickname" | "stageName" | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        displayable?: boolean | null | undefined;
+        name: string;
+        type?: "formerName" | "maidenName" | "nickname" | "stageName" | null | undefined;
+    }, unknown>>>;
+    nameFirst: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nameFull: z.ZodString;
+    nameLast: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nameMiddle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nickname: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publicId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    semanticMatch: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        computedAt: z.ZodISODateTime;
+        cosineDistance: z.ZodNumber;
+        cosineScore: z.ZodNumber;
+        modelVersion: z.ZodString;
+        rank: z.ZodInt;
+        sourceHash: z.ZodString;
+        sourceId: z.ZodString;
+        sourceJson: z.ZodString;
+        sourceText: z.ZodString;
+        sourceType: z.ZodEnum<{
+            agentHelpDoc: "agentHelpDoc";
+            blogPost: "blogPost";
+            classificationCode: "classificationCode";
+            classificationTag: "classificationTag";
+            entity: "entity";
+            newsArticle: "newsArticle";
+            person: "person";
+            product: "product";
+            service: "service";
+            text: "text";
+        }>;
+    }, z.core.$strip>>>;
+    slug: z.ZodString;
+    source: z.ZodObject<{
+        changedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        dataSourceUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingApproval: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        sourceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    suffix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodType<{
+        expanded?: string | null | undefined;
+        generatedDescription?: string | null | undefined;
+        short?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        expanded?: string | null | undefined;
+        generatedDescription?: string | null | undefined;
+        short?: string | null | undefined;
+    }, unknown>>;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+}, z.core.$strip>;
+type PersonDefinition = z.infer<typeof PersonSchemaDefinition>;
+/**
+ * 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}
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @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/detail/resolve
+ * @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
+ * @usedBySchema PagePersonSchema
+ * @usedBySchema PageResultPersonSchema
+ * @usedBySchema PersonDetailSchema
+ * @usedBySchema PersonSimilarityResultSchema
+ * @contractShape person.person
+ * @contractRole canonical
+ */
+export declare const PersonSchema: z.ZodType<PersonDefinition>;
+export type Person = z.infer<typeof PersonSchema>;
+export {};
+//# sourceMappingURL=person.d.ts.map

package/dist/person/person.js

@@ -0,0 +1,78 @@
+// 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";
+const PersonSchemaDefinition = z.object({
+    /** Record creation timestamp */
+    createdAt: z.iso.datetime({ offset: true }).nullish(),
+    gender: z.string().nullish(),
+    /** Canonical person 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. */
+    lastModifiedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Display and search aliases for this person */
+    nameAlias: z.array(EntityNameAliasPersonAliasTypeSchema),
+    nameFirst: z.string().nullish(),
+    nameFull: z.string(),
+    nameLast: z.string().nullish(),
+    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. */
+    publicId: z
+        .string()
+        .regex(/^p[0-9A-Za-z]{12}$/)
+        .nullish(),
+    /** Semantic embedding match evidence populated only for semantic people reads. */
+    semanticMatch: ContentEmbeddingMatchSchema.nullish(),
+    /** Canonical lowercase URL slug for the resource */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255),
+    source: DatasourceSourceMetadataSchema,
+    suffix: z.string().nullish(),
+    /** Grouped person text content */
+    text: EntityTextBundleSchema,
+    /** Last modification timestamp */
+    updatedAt: z.iso.datetime({ offset: true }).nullish(),
+});
+/**
+ * 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}
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @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/detail/resolve
+ * @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
+ * @usedBySchema PagePersonSchema
+ * @usedBySchema PageResultPersonSchema
+ * @usedBySchema PersonDetailSchema
+ * @usedBySchema PersonSimilarityResultSchema
+ * @contractShape person.person
+ * @contractRole canonical
+ */
+export const PersonSchema = PersonSchemaDefinition;
+//# sourceMappingURL=person.js.map

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

@@ -0,0 +1,136 @@
+import { z } from "zod/v4";
+declare const PersonSearchInterpretationSchemaDefinition: z.ZodObject<{
+    confidence: z.ZodEnum<{
+        HIGH: "HIGH";
+        LOW: "LOW";
+        MEDIUM: "MEDIUM";
+    }>;
+    execution: z.ZodType<{
+        modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
+        modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
+    }, unknown, z.core.$ZodTypeInternals<{
+        modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
+        modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
+    }, unknown>>;
+    fallbackUsed: z.ZodBoolean;
+    filter: z.ZodObject<{
+        arrayFilter: z.ZodOptional<z.ZodObject<{
+            amountInvestedRange: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>>;
+            amountRaisedRange: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>>;
+            entityName: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            investedCompany: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            personTitle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            round: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            totalInvestmentCount: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>>;
+            typeRecord: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
+                "Business Line": "Business Line";
+                Company: "Company";
+                Fund: "Fund";
+                Government: "Government";
+                "Investment Firm": "Investment Firm";
+                Nonprofit: "Nonprofit";
+                Organization: "Organization";
+                Product: "Product";
+                Service: "Service";
+            }>>>>;
+        }, z.core.$strip>>;
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        entitySlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        firstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        includeAddress: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        includeUrl: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        investorActivity: z.ZodOptional<z.ZodObject<{
+            averageAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            largestAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            smallestAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            totalAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            totalInvestmentRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+        }, z.core.$strip>>;
+        isCurrent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        letter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        semanticQuery: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    interpretation: z.ZodString;
+    sort: z.ZodType<{
+        order: {
+            descending: boolean;
+            field: "AMOUNT_INVESTED" | "CREATED_AT" | "FIRST_NAME" | "FULL_NAME" | "GENDER" | "ID" | "LAST_NAME" | "SLUG" | "STATUS" | "TOTAL_INVESTMENTS" | "UPDATED_AT";
+        }[];
+        relevance?: "keyword" | "semantic" | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        order: {
+            descending: boolean;
+            field: "AMOUNT_INVESTED" | "CREATED_AT" | "FIRST_NAME" | "FULL_NAME" | "GENDER" | "ID" | "LAST_NAME" | "SLUG" | "STATUS" | "TOTAL_INVESTMENTS" | "UPDATED_AT";
+        }[];
+        relevance?: "keyword" | "semantic" | null | undefined;
+    }, unknown>>;
+    unsupported: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type PersonSearchInterpretationDefinition = z.infer<typeof PersonSearchInterpretationSchemaDefinition>;
+/**
+ * Structured interpretation of a natural-language people search: canonical filter, sort, confidence, and any unsupported constraint the planner could not translate exactly.
+ *
+ * @openapiSchema PersonSearchInterpretation
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema PersonNaturalSearchResultSchema
+ * @contractShape person.search-interpretation
+ * @contractRole canonical
+ */
+export declare const PersonSearchInterpretationSchema: z.ZodType<PersonSearchInterpretationDefinition>;
+export type PersonSearchInterpretation = z.infer<typeof PersonSearchInterpretationSchema>;
+export {};
+//# sourceMappingURL=search-interpretation.d.ts.map

package/dist/person/search-interpretation.js

@@ -0,0 +1,35 @@
+// 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 { ConfidenceSchema } from "../confidence/confidence.js";
+import { PersonFilterSchema } from "./filter.js";
+import { SearchModeExecutionSchema } from "../search/mode-execution.js";
+import { SearchOrderingPersonSortFieldSchema } from "../search/ordering-person-sort-field.js";
+const PersonSearchInterpretationSchemaDefinition = z.object({
+    /** Planner confidence in the structured interpretation. */
+    confidence: ConfidenceSchema,
+    /** Requested and executed search strategy. */
+    execution: SearchModeExecutionSchema,
+    /** True when the semantic fallback replaced an unconstrained planner result with a semantic search over the original query. */
+    fallbackUsed: z.boolean(),
+    /** Canonical person filter generated from the natural-language query. */
+    filter: PersonFilterSchema,
+    /** Human-readable summary of how the query was interpreted. */
+    interpretation: z.string(),
+    /** Ordering applied to the result page: the relevance rank that ran first, if any, then the sortable-column terms. */
+    sort: SearchOrderingPersonSortFieldSchema,
+    /** Constraint the planner could not translate into the canonical PersonFilter contract; null when every material constraint was supported. */
+    unsupported: z.string().nullish(),
+});
+/**
+ * Structured interpretation of a natural-language people search: canonical filter, sort, confidence, and any unsupported constraint the planner could not translate exactly.
+ *
+ * @openapiSchema PersonSearchInterpretation
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema PersonNaturalSearchResultSchema
+ * @contractShape person.search-interpretation
+ * @contractRole canonical
+ */
+export const PersonSearchInterpretationSchema = PersonSearchInterpretationSchemaDefinition;
+//# sourceMappingURL=search-interpretation.js.map

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

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+export declare const PERSON_SEARCH_ENDPOINT: "/v1/people/search";
+/**
+ * Request-side query params for `POST /v1/people/search`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/people/search
+ * @contractShape person.search-param
+ * @contractRole canonical
+ */
+export declare const PersonSearchParamSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodInt>;
+    size: z.ZodOptional<z.ZodInt>;
+    sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    countOnly: z.ZodOptional<z.ZodBoolean>;
+    hasImageFirst: z.ZodOptional<z.ZodBoolean>;
+    includePrivate: z.ZodOptional<z.ZodBoolean>;
+    permitMonogram: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PersonSearchParam = z.infer<typeof PersonSearchParamSchema>;
+//# sourceMappingURL=search-param.d.ts.map

package/dist/person/search-param.js

@@ -0,0 +1,24 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { PageParamSchema } from "../pagination/page-param.js";
+export const PERSON_SEARCH_ENDPOINT = "/v1/people/search";
+/**
+ * Request-side query params for `POST /v1/people/search`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/people/search
+ * @contractShape person.search-param
+ * @contractRole canonical
+ */
+export const PersonSearchParamSchema = PageParamSchema.extend({
+    /** When true, return only the page total in the body and skip the content payload. */
+    countOnly: z.boolean().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. */
+    includePrivate: z.boolean().optional(),
+    /** When false, monogram fallback logos are stripped from the response. Defaults to true. */
+    permitMonogram: z.boolean().optional(),
+});
+//# sourceMappingURL=search-param.js.map

package/dist/person/similar-param.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+export declare const PERSON_SIMILAR_ENDPOINT: "/v1/people/{personId}/similar";
+/**
+ * Request-side query params for `GET /v1/people/{personId}/similar`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/people/{personId}/similar
+ * @contractShape person.similar-param
+ * @contractRole canonical
+ */
+export declare const PersonSimilarParamSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodDefault<z.ZodInt>>;
+    permitMonogram: z.ZodOptional<z.ZodBoolean>;
+    size: z.ZodOptional<z.ZodDefault<z.ZodInt>>;
+}, z.core.$strip>;
+export type PersonSimilarParam = z.infer<typeof PersonSimilarParamSchema>;
+//# sourceMappingURL=similar-param.d.ts.map

package/dist/person/similar-param.js

@@ -0,0 +1,21 @@
+// 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";
+export const PERSON_SIMILAR_ENDPOINT = "/v1/people/{personId}/similar";
+/**
+ * Request-side query params for `GET /v1/people/{personId}/similar`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/people/{personId}/similar
+ * @contractShape person.similar-param
+ * @contractRole canonical
+ */
+export const PersonSimilarParamSchema = z.object({
+    /** Zero-based page index (0..N) */
+    page: z.int().min(0).default(0).optional(),
+    /** Permit monogram fallback */
+    permitMonogram: z.boolean().optional(),
+    /** The size of the page to be returned */
+    size: z.int().min(1).default(10).optional(),
+});
+//# sourceMappingURL=similar-param.js.map

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

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+declare const PersonSimilarityContextSchemaDefinition: z.ZodObject<{
+    compositeScore: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cosineScore: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    matchedSectionWeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    origin: z.ZodEnum<{
+        live: "live";
+        precomputed: "precomputed";
+    }>;
+    rank: z.ZodInt;
+    sharedSectionCount: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+}, z.core.$strip>;
+type PersonSimilarityContextDefinition = z.infer<typeof PersonSimilarityContextSchemaDefinition>;
+/**
+ * Per-row provenance for a similar-person result.
+ *
+ * @openapiSchema PersonSimilarityContext
+ * @endpoint GET /v1/people/{personId}/similar
+ * @usedBySchema PersonSimilarityResultSchema
+ * @contractShape person.similarity-context
+ * @contractRole canonical
+ */
+export declare const PersonSimilarityContextSchema: z.ZodType<PersonSimilarityContextDefinition>;
+export type PersonSimilarityContext = z.infer<typeof PersonSimilarityContextSchema>;
+export {};
+//# sourceMappingURL=similarity-context.d.ts.map

package/dist/person/similarity-context.js

@@ -0,0 +1,27 @@
+// 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 { PersonSimilarityOriginSchema } from "./similarity-origin.js";
+const PersonSimilarityContextSchemaDefinition = z.object({
+    /** Composite section-fusion similarity score. */
+    compositeScore: z.number().nullish(),
+    /** Cosine similarity score where higher is closer. */
+    cosineScore: z.number().nullish(),
+    /** Total normalized source-section weight matched. */
+    matchedSectionWeight: z.number().nullish(),
+    origin: PersonSimilarityOriginSchema,
+    /** 1-based position in the merged result page */
+    rank: z.int(),
+    /** Number of source/target sections compared. */
+    sharedSectionCount: z.int().nullish(),
+});
+/**
+ * Per-row provenance for a similar-person result.
+ *
+ * @openapiSchema PersonSimilarityContext
+ * @endpoint GET /v1/people/{personId}/similar
+ * @usedBySchema PersonSimilarityResultSchema
+ * @contractShape person.similarity-context
+ * @contractRole canonical
+ */
+export const PersonSimilarityContextSchema = PersonSimilarityContextSchemaDefinition;
+//# sourceMappingURL=similarity-context.js.map

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

@@ -0,0 +1,16 @@
+import { z } from "zod/v4";
+/**
+ * Provenance origin for a similar-person result row.
+ *
+ * @openapiSchema PersonSimilarityOrigin
+ * @endpoint GET /v1/people/{personId}/similar
+ * @usedBySchema PersonSimilarityContextSchema
+ * @contractShape person.similarity-origin
+ * @contractRole canonical
+ */
+export declare const PersonSimilarityOriginSchema: z.ZodEnum<{
+    live: "live";
+    precomputed: "precomputed";
+}>;
+export type PersonSimilarityOrigin = z.infer<typeof PersonSimilarityOriginSchema>;
+//# sourceMappingURL=similarity-origin.d.ts.map

package/dist/person/similarity-origin.js

@@ -0,0 +1,13 @@
+// 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";
+/**
+ * Provenance origin for a similar-person result row.
+ *
+ * @openapiSchema PersonSimilarityOrigin
+ * @endpoint GET /v1/people/{personId}/similar
+ * @usedBySchema PersonSimilarityContextSchema
+ * @contractShape person.similarity-origin
+ * @contractRole canonical
+ */
+export const PersonSimilarityOriginSchema = z.enum(["precomputed", "live"]);
+//# sourceMappingURL=similarity-origin.js.map