@aventurevc/api-schemas 0.7.272

package/dist/unique/id-type.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";
+/**
+ * External identifier type that maps an owner to a registry id: ein, secCik, ticker, lei, duns, isin, cusip, crd, or orcid.
+ *
+ * @openapiSchema UniqueIdType
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/unique-ids/lookup
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/unique-ids
+ * @endpoint GET /v1/entities/{entityId}/unique-ids/{uniqueIdId}
+ * @endpoint GET /v1/people/{personId}/unique-ids
+ * @endpoint GET /v1/people/{personId}/unique-ids/{uniqueIdId}
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @usedBySchema UniqueIdSchema
+ * @contractShape unique.id-type
+ * @contractRole canonical
+ */
+export const UniqueIdTypeSchema = z.enum([
+    "ein",
+    "secCik",
+    "ticker",
+    "lei",
+    "duns",
+    "isin",
+    "cusip",
+    "crd",
+    "orcid",
+]);
+//# sourceMappingURL=id-type.js.map

package/dist/unique/id.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod/v4";
+declare const UniqueIdSchemaDefinition: z.ZodObject<{
+    createdAt: z.ZodISODateTime;
+    id: z.ZodInt;
+    identifier: z.ZodString;
+    idType: z.ZodEnum<{
+        crd: "crd";
+        cusip: "cusip";
+        duns: "duns";
+        ein: "ein";
+        isin: "isin";
+        lei: "lei";
+        orcid: "orcid";
+        secCik: "secCik";
+        ticker: "ticker";
+    }>;
+    owner: z.ZodObject<{
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>;
+    source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type UniqueIdDefinition = z.infer<typeof UniqueIdSchemaDefinition>;
+/**
+ * External identifier mapped to one owner (entity or person): for example a company's EIN, SEC CIK, or ticker symbol. Owner carries exactly one entityId or personId.
+ *
+ * @openapiSchema UniqueId
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/unique-ids/lookup
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/unique-ids
+ * @endpoint GET /v1/entities/{entityId}/unique-ids/{uniqueIdId}
+ * @endpoint GET /v1/people/{personId}/unique-ids
+ * @endpoint GET /v1/people/{personId}/unique-ids/{uniqueIdId}
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @usedBySchema EntityDetailSchema
+ * @usedBySchema PageUniqueIdSchema
+ * @contractShape unique.id
+ * @contractRole canonical
+ */
+export declare const UniqueIdSchema: z.ZodType<UniqueIdDefinition>;
+export type UniqueId = z.infer<typeof UniqueIdSchema>;
+export {};
+//# sourceMappingURL=id.d.ts.map

package/dist/unique/id.js

@@ -0,0 +1,44 @@
+// 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 { EntityPersonOwnerSchema } from "../entity/person-owner.js";
+import { UniqueIdTypeSchema } from "./id-type.js";
+const UniqueIdSchemaDefinition = z.object({
+    /** Row creation timestamp. */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** Unique-id row id. */
+    id: z.int(),
+    /** Identifier value as issued by the registry (normalized per type). */
+    identifier: z.string(),
+    /** Identifier type. */
+    idType: UniqueIdTypeSchema,
+    /** Owning entity or person id; exactly one nested id is present. */
+    owner: EntityPersonOwnerSchema,
+    /** Attribution source label for the mapping, when recorded. */
+    source: z.string().nullish(),
+    /** Row update timestamp. */
+    updatedAt: z.iso.datetime({ offset: true }),
+});
+/**
+ * External identifier mapped to one owner (entity or person): for example a company's EIN, SEC CIK, or ticker symbol. Owner carries exactly one entityId or personId.
+ *
+ * @openapiSchema UniqueId
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/unique-ids/lookup
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/unique-ids
+ * @endpoint GET /v1/entities/{entityId}/unique-ids/{uniqueIdId}
+ * @endpoint GET /v1/people/{personId}/unique-ids
+ * @endpoint GET /v1/people/{personId}/unique-ids/{uniqueIdId}
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @usedBySchema EntityDetailSchema
+ * @usedBySchema PageUniqueIdSchema
+ * @contractShape unique.id
+ * @contractRole canonical
+ */
+export const UniqueIdSchema = UniqueIdSchemaDefinition;
+//# sourceMappingURL=id.js.map

package/dist/uptime/uptime.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const UptimeSchemaDefinition: z.ZodObject<{
+    availability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    downtimeSeconds: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    incidents: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+}, z.core.$strip>;
+type UptimeDefinition = z.infer<typeof UptimeSchemaDefinition>;
+/**
+ * Uptime SLA data from Better Stack monitoring
+ *
+ * @openapiSchema Uptime
+ * @endpoint GET /v1/status
+ * @usedBySchema SystemStatusSchema
+ * @contractShape uptime.uptime
+ * @contractRole canonical
+ */
+export declare const UptimeSchema: z.ZodType<UptimeDefinition>;
+export type Uptime = z.infer<typeof UptimeSchema>;
+export {};
+//# sourceMappingURL=uptime.d.ts.map

package/dist/uptime/uptime.js

@@ -0,0 +1,23 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const UptimeSchemaDefinition = z.object({
+    /** Uptime percentage */
+    availability: z.number().nullish(),
+    /** Total downtime in seconds */
+    downtimeSeconds: z.int().nullish(),
+    /** Error message if unavailable */
+    error: z.string().nullish(),
+    /** Number of incidents */
+    incidents: z.int().nullish(),
+});
+/**
+ * Uptime SLA data from Better Stack monitoring
+ *
+ * @openapiSchema Uptime
+ * @endpoint GET /v1/status
+ * @usedBySchema SystemStatusSchema
+ * @contractShape uptime.uptime
+ * @contractRole canonical
+ */
+export const UptimeSchema = UptimeSchemaDefinition;
+//# sourceMappingURL=uptime.js.map

package/dist/url/duplicate-conflict.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod/v4";
+declare const UrlDuplicateConflictSchemaDefinition: z.ZodObject<{
+    existingJoin: z.ZodArray<z.ZodType<{
+        owner: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        urlId: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        owner: {
+            entityId?: string | null | undefined;
+            personId?: string | null | undefined;
+        };
+        urlId: number;
+    }, unknown>>>;
+    fragmentIgnored: z.ZodBoolean;
+    guidance: z.ZodString;
+    normalizedUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    requestedOwner: z.ZodObject<{
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>;
+    url: z.ZodString;
+    urlType: z.ZodString;
+}, z.core.$strip>;
+type UrlDuplicateConflictDefinition = z.infer<typeof UrlDuplicateConflictSchemaDefinition>;
+/**
+ * Typed extension on ProblemDetail.details for HTTP 409 when a create/update attempts to set a URL with urlType=website (or another exclusive urlType) that is already a current URL on a different entity or person. The existingJoin list names every current owner of the normalized URL; resolve by demoting the existing owner (isCurrent=false, isPrimary=false) before promoting the new owner.
+ *
+ * @openapiSchema UrlDuplicateConflict
+ * @standardProblemResponse
+ * @usedBySchema DomainConflictDetailsSchema
+ * @contractShape url.duplicate-conflict
+ * @contractRole canonical
+ */
+export declare const UrlDuplicateConflictSchema: z.ZodType<UrlDuplicateConflictDefinition>;
+export type UrlDuplicateConflict = z.infer<typeof UrlDuplicateConflictSchema>;
+export {};
+//# sourceMappingURL=duplicate-conflict.d.ts.map

package/dist/url/duplicate-conflict.js

@@ -0,0 +1,31 @@
+// 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 { EntityPersonOwnerSchema } from "../entity/person-owner.js";
+import { UrlDuplicateJoinSchema } from "./duplicate-join.js";
+const UrlDuplicateConflictSchemaDefinition = z.object({
+    /** Every current owner that already holds the normalized URL with this urlType. Non-empty when this conflict is emitted. */
+    existingJoin: z.array(UrlDuplicateJoinSchema),
+    /** True when URL fragment differences were ignored during duplicate matching (i.e., the conflict ignores everything after '#'). */
+    fragmentIgnored: z.boolean(),
+    /** Human-readable guidance on how to resolve the conflict. Defaults to the standard inspect-then-demote/promote sequence. */
+    guidance: z.string(),
+    /** Normalized URL match key used for duplicate detection. Null when normalization could not produce a stable key (e.g., malformed input). */
+    normalizedUrl: z.string().nullish(),
+    /** Owner the caller attempted to attach the URL to. */
+    requestedOwner: EntityPersonOwnerSchema,
+    /** Raw URL as submitted by the caller (pre-normalization). */
+    url: z.string(),
+    /** URL type submitted by the caller (e.g., 'website', 'twitter'). The conflict applies only within this urlType. */
+    urlType: z.string(),
+});
+/**
+ * Typed extension on ProblemDetail.details for HTTP 409 when a create/update attempts to set a URL with urlType=website (or another exclusive urlType) that is already a current URL on a different entity or person. The existingJoin list names every current owner of the normalized URL; resolve by demoting the existing owner (isCurrent=false, isPrimary=false) before promoting the new owner.
+ *
+ * @openapiSchema UrlDuplicateConflict
+ * @standardProblemResponse
+ * @usedBySchema DomainConflictDetailsSchema
+ * @contractShape url.duplicate-conflict
+ * @contractRole canonical
+ */
+export const UrlDuplicateConflictSchema = UrlDuplicateConflictSchemaDefinition;
+//# sourceMappingURL=duplicate-conflict.js.map

package/dist/url/duplicate-join.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const UrlDuplicateJoinSchemaDefinition: z.ZodObject<{
+    owner: z.ZodObject<{
+        entityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        personId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>;
+    urlId: z.ZodInt;
+}, z.core.$strip>;
+type UrlDuplicateJoinDefinition = z.infer<typeof UrlDuplicateJoinSchemaDefinition>;
+/**
+ * URL ownership join row identifying which entity or person currently owns a normalized URL.
+ *
+ * @openapiSchema UrlDuplicateJoin
+ * @standardProblemResponse
+ * @usedBySchema UrlDuplicateConflictSchema
+ * @contractShape url.duplicate-join
+ * @contractRole canonical
+ */
+export declare const UrlDuplicateJoinSchema: z.ZodType<UrlDuplicateJoinDefinition>;
+export type UrlDuplicateJoin = z.infer<typeof UrlDuplicateJoinSchema>;
+export {};
+//# sourceMappingURL=duplicate-join.d.ts.map

package/dist/url/duplicate-join.js

@@ -0,0 +1,20 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
+const UrlDuplicateJoinSchemaDefinition = z.object({
+    /** Owner of the URL: either entityId or personId is populated depending on the owner kind. Use the populated id to read or update the owner's URL. */
+    owner: EntityPersonOwnerSchema,
+    /** Internal URL row id (res_weburl.id) — opaque to API clients. */
+    urlId: z.int(),
+});
+/**
+ * URL ownership join row identifying which entity or person currently owns a normalized URL.
+ *
+ * @openapiSchema UrlDuplicateJoin
+ * @standardProblemResponse
+ * @usedBySchema UrlDuplicateConflictSchema
+ * @contractShape url.duplicate-join
+ * @contractRole canonical
+ */
+export const UrlDuplicateJoinSchema = UrlDuplicateJoinSchemaDefinition;
+//# sourceMappingURL=duplicate-join.js.map

package/dist/url/match-mode.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+/**
+ * URL matching mode for URL-backed filters and duplicate checks.
+ *
+ * @openapiSchema UrlMatchMode
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/filters/refine
+ * @endpoint POST /v1/entities/filters/search
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityFilterSchema
+ * @usedBySchema EntityListFilterSchema
+ * @contractShape url.match-mode
+ * @contractRole canonical
+ */
+export declare const UrlMatchModeSchema: z.ZodEnum<{
+    domain: "domain";
+    hostPath: "hostPath";
+}>;
+export type UrlMatchMode = z.infer<typeof UrlMatchModeSchema>;
+//# sourceMappingURL=match-mode.d.ts.map

package/dist/url/match-mode.js

@@ -0,0 +1,22 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+/**
+ * URL matching mode for URL-backed filters and duplicate checks.
+ *
+ * @openapiSchema UrlMatchMode
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/search/link
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/filters/refine
+ * @endpoint POST /v1/entities/filters/search
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityFilterSchema
+ * @usedBySchema EntityListFilterSchema
+ * @contractShape url.match-mode
+ * @contractRole canonical
+ */
+export const UrlMatchModeSchema = z.enum(["hostPath", "domain"]);
+//# sourceMappingURL=match-mode.js.map

package/dist/url/slug-redirect.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+declare const UrlSlugRedirectSchemaDefinition: z.ZodObject<{
+    createdAt: z.ZodISODateTime;
+    newUrl: z.ZodString;
+    oldUrl: z.ZodString;
+    redirectId: z.ZodInt;
+    redirectType: z.ZodInt;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type UrlSlugRedirectDefinition = z.infer<typeof UrlSlugRedirectSchemaDefinition>;
+/**
+ * URL slug redirect row
+ *
+ * @openapiSchema UrlSlugRedirect
+ * @endpoint GET /v1/entities/{entityId}/slug/redirects
+ * @endpoint GET /v1/news/{newsId}/slug/redirects
+ * @endpoint GET /v1/people/{personId}/slug/redirects
+ * @usedBySchema PageUrlSlugRedirectSchema
+ * @contractShape url.slug-redirect
+ * @contractRole canonical
+ */
+export declare const UrlSlugRedirectSchema: z.ZodType<UrlSlugRedirectDefinition>;
+export type UrlSlugRedirect = z.infer<typeof UrlSlugRedirectSchema>;
+export {};
+//# sourceMappingURL=slug-redirect.d.ts.map

package/dist/url/slug-redirect.js

@@ -0,0 +1,29 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const UrlSlugRedirectSchemaDefinition = z.object({
+    /** Redirect row creation timestamp */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** New public URL, e.g., /companies/new-slug */
+    newUrl: z.string(),
+    /** Old public URL, e.g., /companies/old-slug */
+    oldUrl: z.string(),
+    /** Redirect row id */
+    redirectId: z.int(),
+    /** HTTP redirect type; permanent 301 */
+    redirectType: z.int(),
+    /** Redirect row update timestamp */
+    updatedAt: z.iso.datetime({ offset: true }),
+});
+/**
+ * URL slug redirect row
+ *
+ * @openapiSchema UrlSlugRedirect
+ * @endpoint GET /v1/entities/{entityId}/slug/redirects
+ * @endpoint GET /v1/news/{newsId}/slug/redirects
+ * @endpoint GET /v1/people/{personId}/slug/redirects
+ * @usedBySchema PageUrlSlugRedirectSchema
+ * @contractShape url.slug-redirect
+ * @contractRole canonical
+ */
+export const UrlSlugRedirectSchema = UrlSlugRedirectSchemaDefinition;
+//# sourceMappingURL=slug-redirect.js.map

package/dist/url/surface-misclassification-catalog.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod/v4";
+declare const UrlSurfaceMisclassificationCatalogSchemaDefinition: z.ZodObject<{
+    assetExtension: z.ZodArray<z.ZodString>;
+    newsArticleHost: z.ZodArray<z.ZodString>;
+    parkingHost: z.ZodArray<z.ZodString>;
+    route: z.ZodArray<z.ZodType<{
+        additionalGuidance?: string | null | undefined;
+        apiEndpoint: string;
+        attemptedSurface: string[];
+        cliCommand: string;
+        correctSurface: string;
+        deterministicUrlShape: string;
+        exactPath: string[];
+        externalSocialPostPlatform?: "facebook" | "instagram" | "linkedin" | "other" | "threads" | "tiktok" | "xTwitter" | null | undefined;
+        hostSuffix: string;
+        id: string;
+        pathPrefix: string[];
+        pathTemplate: string[];
+        requiredLastSegment?: string | null | undefined;
+        requiredSegment?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        additionalGuidance?: string | null | undefined;
+        apiEndpoint: string;
+        attemptedSurface: string[];
+        cliCommand: string;
+        correctSurface: string;
+        deterministicUrlShape: string;
+        exactPath: string[];
+        externalSocialPostPlatform?: "facebook" | "instagram" | "linkedin" | "other" | "threads" | "tiktok" | "xTwitter" | null | undefined;
+        hostSuffix: string;
+        id: string;
+        pathPrefix: string[];
+        pathTemplate: string[];
+        requiredLastSegment?: string | null | undefined;
+        requiredSegment?: string | null | undefined;
+    }, unknown>>>;
+}, z.core.$strip>;
+type UrlSurfaceMisclassificationCatalogDefinition = z.infer<typeof UrlSurfaceMisclassificationCatalogSchemaDefinition>;
+/**
+ * URL surface misclassification catalog. Consumers MUST route these URL shapes to the named canonical surface instead of writing them to the attempted surface.
+ *
+ * @openapiSchema UrlSurfaceMisclassificationCatalog
+ * @endpoint GET /v1/entities/urls/surface-misclassifications
+ * @contractShape url.surface-misclassification-catalog
+ * @contractRole canonical
+ */
+export declare const UrlSurfaceMisclassificationCatalogSchema: z.ZodType<UrlSurfaceMisclassificationCatalogDefinition>;
+export type UrlSurfaceMisclassificationCatalog = z.infer<typeof UrlSurfaceMisclassificationCatalogSchema>;
+export {};
+//# sourceMappingURL=surface-misclassification-catalog.d.ts.map

package/dist/url/surface-misclassification-catalog.js

@@ -0,0 +1,23 @@
+// 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 { UrlSurfaceMisclassificationRouteSchema } from "./surface-misclassification-route.js";
+const UrlSurfaceMisclassificationCatalogSchemaDefinition = z.object({
+    /** Binary asset file extensions (no leading dot) — an asset is not a web page. */
+    assetExtension: z.array(z.string()),
+    /** Pure news/press-wire hosts. An article path on these is a news record, never a URL link; the outlet's own root stays a valid website. */
+    newsArticleHost: z.array(z.string()),
+    /** Domain-marketplace / for-sale / parking hosts — the domain is unowned, never a URL. */
+    parkingHost: z.array(z.string()),
+    /** Deterministic URL path routes whose canonical surface is not the attempted write surface. */
+    route: z.array(UrlSurfaceMisclassificationRouteSchema),
+});
+/**
+ * URL surface misclassification catalog. Consumers MUST route these URL shapes to the named canonical surface instead of writing them to the attempted surface.
+ *
+ * @openapiSchema UrlSurfaceMisclassificationCatalog
+ * @endpoint GET /v1/entities/urls/surface-misclassifications
+ * @contractShape url.surface-misclassification-catalog
+ * @contractRole canonical
+ */
+export const UrlSurfaceMisclassificationCatalogSchema = UrlSurfaceMisclassificationCatalogSchemaDefinition;
+//# sourceMappingURL=surface-misclassification-catalog.js.map

package/dist/url/surface-misclassification-route.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod/v4";
+declare const UrlSurfaceMisclassificationRouteSchemaDefinition: z.ZodObject<{
+    additionalGuidance: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    apiEndpoint: z.ZodString;
+    attemptedSurface: z.ZodArray<z.ZodString>;
+    cliCommand: z.ZodString;
+    correctSurface: z.ZodString;
+    deterministicUrlShape: z.ZodString;
+    exactPath: z.ZodArray<z.ZodString>;
+    externalSocialPostPlatform: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        facebook: "facebook";
+        instagram: "instagram";
+        linkedin: "linkedin";
+        other: "other";
+        threads: "threads";
+        tiktok: "tiktok";
+        xTwitter: "xTwitter";
+    }>>>;
+    hostSuffix: z.ZodString;
+    id: z.ZodString;
+    pathPrefix: z.ZodArray<z.ZodString>;
+    pathTemplate: z.ZodArray<z.ZodString>;
+    requiredLastSegment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    requiredSegment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type UrlSurfaceMisclassificationRouteDefinition = z.infer<typeof UrlSurfaceMisclassificationRouteSchemaDefinition>;
+/**
+ * One deterministic URL shape and the canonical surface it must be routed to.
+ *
+ * @openapiSchema UrlSurfaceMisclassificationRoute
+ * @endpoint GET /v1/entities/urls/surface-misclassifications
+ * @usedBySchema UrlSurfaceMisclassificationCatalogSchema
+ * @contractShape url.surface-misclassification-route
+ * @contractRole canonical
+ */
+export declare const UrlSurfaceMisclassificationRouteSchema: z.ZodType<UrlSurfaceMisclassificationRouteDefinition>;
+export type UrlSurfaceMisclassificationRoute = z.infer<typeof UrlSurfaceMisclassificationRouteSchema>;
+export {};
+//# sourceMappingURL=surface-misclassification-route.d.ts.map

package/dist/url/surface-misclassification-route.js

@@ -0,0 +1,44 @@
+// 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 { ExternalSocialPostPlatformSchema } from "../external/social-post-platform.js";
+const UrlSurfaceMisclassificationRouteSchemaDefinition = z.object({
+    /** Additional routing guidance for agents and API clients. */
+    additionalGuidance: z.string().nullish(),
+    /** Canonical API endpoint or discovery endpoint. */
+    apiEndpoint: z.string(),
+    /** Attempted write surfaces this route rejects. */
+    attemptedSurface: z.array(z.string()),
+    /** Canonical aventure-cli guidance. */
+    cliCommand: z.string(),
+    /** Canonical aVenture write surface. */
+    correctSurface: z.string(),
+    /** Human-readable deterministic URL shape. */
+    deterministicUrlShape: z.string(),
+    /** Exact path segments, when the whole path must match. */
+    exactPath: z.array(z.string()),
+    /** Publishing platform for an external-social permalink route. */
+    externalSocialPostPlatform: ExternalSocialPostPlatformSchema.nullish(),
+    /** Host suffix matched against the submitted URL host. */
+    hostSuffix: z.string(),
+    /** Stable YAML key for this route. */
+    id: z.string(),
+    /** Required leading path segments. */
+    pathPrefix: z.array(z.string()),
+    /** Exact external-social permalink template. Literals match exactly, * matches one nonblank segment, and @* matches one @handle segment. */
+    pathTemplate: z.array(z.string()),
+    /** Required final path segment, when applicable. */
+    requiredLastSegment: z.string().nullish(),
+    /** Required path segment at any position, for shapes whose discriminating segment follows a variable owner handle. */
+    requiredSegment: z.string().nullish(),
+});
+/**
+ * One deterministic URL shape and the canonical surface it must be routed to.
+ *
+ * @openapiSchema UrlSurfaceMisclassificationRoute
+ * @endpoint GET /v1/entities/urls/surface-misclassifications
+ * @usedBySchema UrlSurfaceMisclassificationCatalogSchema
+ * @contractShape url.surface-misclassification-route
+ * @contractRole canonical
+ */
+export const UrlSurfaceMisclassificationRouteSchema = UrlSurfaceMisclassificationRouteSchemaDefinition;
+//# sourceMappingURL=surface-misclassification-route.js.map

package/dist/url/type-alias.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const UrlTypeAliasSchemaDefinition: z.ZodObject<{
+    alias: z.ZodArray<z.ZodString>;
+    canonical: z.ZodString;
+    hostDomain: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type UrlTypeAliasDefinition = z.infer<typeof UrlTypeAliasSchemaDefinition>;
+/**
+ * Canonical urlType value plus accepted alias and platform host tokens.
+ *
+ * @openapiSchema UrlTypeAlias
+ * @endpoint GET /v1/entities/urls/types
+ * @endpoint GET /v1/people/urls/types
+ * @endpoint GET /v1/url-types
+ * @contractShape url.type-alias
+ * @contractRole canonical
+ */
+export declare const UrlTypeAliasSchema: z.ZodType<UrlTypeAliasDefinition>;
+export type UrlTypeAlias = z.infer<typeof UrlTypeAliasSchema>;
+export {};
+//# sourceMappingURL=type-alias.d.ts.map

package/dist/url/type-alias.js

@@ -0,0 +1,22 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const UrlTypeAliasSchemaDefinition = z.object({
+    /** Alias tokens accepted by UrlTypeCatalog.fromRaw. */
+    alias: z.array(z.string()),
+    /** Canonical urlType value. */
+    canonical: z.string(),
+    /** Host domains used by URL inference for this urlType. */
+    hostDomain: z.array(z.string()),
+});
+/**
+ * Canonical urlType value plus accepted alias and platform host tokens.
+ *
+ * @openapiSchema UrlTypeAlias
+ * @endpoint GET /v1/entities/urls/types
+ * @endpoint GET /v1/people/urls/types
+ * @endpoint GET /v1/url-types
+ * @contractShape url.type-alias
+ * @contractRole canonical
+ */
+export const UrlTypeAliasSchema = UrlTypeAliasSchemaDefinition;
+//# sourceMappingURL=type-alias.js.map

package/dist/valuation/type.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * Which side of the pre/post relationship the source declared.
+ *
+ * @openapiSchema ValuationType
+ * @endpoint GET /v1/entities/detail/financial/valuation
+ * @usedBySchema EntityValuationTimeSeriesPointSchema
+ * @contractShape valuation.type
+ * @contractRole canonical
+ */
+export declare const ValuationTypeSchema: z.ZodEnum<{
+    postMoney: "postMoney";
+    preMoney: "preMoney";
+    reported: "reported";
+}>;
+export type ValuationType = z.infer<typeof ValuationTypeSchema>;
+//# sourceMappingURL=type.d.ts.map

package/dist/valuation/type.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";
+/**
+ * Which side of the pre/post relationship the source declared.
+ *
+ * @openapiSchema ValuationType
+ * @endpoint GET /v1/entities/detail/financial/valuation
+ * @usedBySchema EntityValuationTimeSeriesPointSchema
+ * @contractShape valuation.type
+ * @contractRole canonical
+ */
+export const ValuationTypeSchema = z.enum(["preMoney", "postMoney", "reported"]);
+//# sourceMappingURL=type.js.map