@aventurevc/api-schemas 0.8.179 → 0.8.181

package/dist/billing/next-charge.d.ts

@@ -16,6 +16,7 @@ declare const BillingNextChargeSchemaDefinition: z.ZodObject<{
         name?: string | null | undefined;
         percentOff?: number | null | undefined;
     }, import("./discount.ts").BillingDiscountSchemaInput>>>;
+    totalExcludingTax: z.ZodNumber;
 }, z.core.$strip>;
 type BillingNextChargeDefinition = z.infer<typeof BillingNextChargeSchemaDefinition>;
 export interface BillingNextChargeSchemaInput extends z.input<typeof BillingNextChargeSchemaDefinition> {

package/dist/billing/next-charge.js

@@ -10,6 +10,8 @@ const BillingNextChargeSchemaDefinition = z.object({
     currency: z.string(),
     /** Discounts applied to the next invoice; empty when none apply */
     discount: z.array(BillingDiscountSchema),
+    /** Next invoice total in the currency's minor unit after discounts, before tax and account credit; compare it, not amountDue, with the plan's price */
+    totalExcludingTax: z.number().int(),
 });
 /**
  * Next invoice of the caller's renewing Stripe subscription as Stripe previews it, after discounts and credits.

package/dist/entity/url-crawl-cdn-provider.d.ts

@@ -6,6 +6,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities
  * @endpoint GET /v1/entities/brand
  * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/lookup
  * @endpoint GET /v1/people/lookup-exact
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -27,15 +28,19 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/entities/lookup
  * @endpoint POST /v1/entities/lookup-batch
  * @endpoint POST /v1/entities/lookup-matches
  * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/lookup
  * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
  * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityUrlLinkSchema
+ * @usedBySchema UrlHostFormResolutionSchema
  * @contractShape entity.url-crawl-cdn-provider
  * @contractRole canonical
  */

package/dist/entity/url-crawl-cdn-provider.js

@@ -7,6 +7,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities
  * @endpoint GET /v1/entities/brand
  * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/lookup
  * @endpoint GET /v1/people/lookup-exact
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -28,15 +29,19 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/entities/lookup
  * @endpoint POST /v1/entities/lookup-batch
  * @endpoint POST /v1/entities/lookup-matches
  * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/lookup
  * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
  * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityUrlLinkSchema
+ * @usedBySchema UrlHostFormResolutionSchema
  * @contractShape entity.url-crawl-cdn-provider
  * @contractRole canonical
  */

package/dist/entity/url-crawl-render-mode.d.ts

@@ -6,6 +6,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities
  * @endpoint GET /v1/entities/brand
  * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/lookup
  * @endpoint GET /v1/people/lookup-exact
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -27,15 +28,19 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/entities/lookup
  * @endpoint POST /v1/entities/lookup-batch
  * @endpoint POST /v1/entities/lookup-matches
  * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/lookup
  * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
  * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityUrlLinkSchema
+ * @usedBySchema UrlHostFormResolutionSchema
  * @contractShape entity.url-crawl-render-mode
  * @contractRole canonical
  */

package/dist/entity/url-crawl-render-mode.js

@@ -7,6 +7,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities
  * @endpoint GET /v1/entities/brand
  * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/lookup
  * @endpoint GET /v1/people/lookup-exact
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -28,15 +29,19 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/entities/lookup
  * @endpoint POST /v1/entities/lookup-batch
  * @endpoint POST /v1/entities/lookup-matches
  * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/lookup
  * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
  * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityUrlLinkSchema
+ * @usedBySchema UrlHostFormResolutionSchema
  * @contractShape entity.url-crawl-render-mode
  * @contractRole canonical
  */

package/dist/identification/identification.d.ts

@@ -200,6 +200,25 @@ export declare const IdentificationSchema: z.ZodObject<{
         NEEDS_REVIEW: "NEEDS_REVIEW";
         NO_MATCH: "NO_MATCH";
     }>;
+    urlHostForm: z.ZodArray<z.ZodType<{
+        concluded: boolean;
+        crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+        crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+        landingHost?: string | null | undefined;
+        outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+        status?: string | null | undefined;
+        submittedUrl: string;
+        url: string;
+    }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput, z.core.$ZodTypeInternals<{
+        concluded: boolean;
+        crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+        crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+        landingHost?: string | null | undefined;
+        outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+        status?: string | null | undefined;
+        submittedUrl: string;
+        url: string;
+    }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput>>>;
 }, z.core.$strip>;
 export type Identification = z.infer<typeof IdentificationSchema>;
 //# sourceMappingURL=identification.d.ts.map

package/dist/identification/identification.js

@@ -1,6 +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";
 import { IdentificationCandidateSchema } from "./candidate.js";
+import { UrlHostFormResolutionSchema } from "../url/host-form-resolution.js";
 /**
  * Which existing entity or person satisfies the requested identity, type, and provider scope, how that was settled, and the candidates considered, most probable first.
  *
@@ -19,13 +20,13 @@ import { IdentificationCandidateSchema } from "./candidate.js";
 export const IdentificationSchema = z.object({
     /** Records considered, most probable first. */
     candidate: z.array(IdentificationCandidateSchema),
-    /** With fileOnMiss=true, the new record this NO_MATCH created, or the existing one that already held its website. Absent otherwise. */
+    /** The new unpublished record a NO_MATCH subject with a proven own site was added as, or the existing one that already held its website. Absent otherwise. */
     created: IdentificationCandidateSchema.nullish(),
     /** One sentence naming what settled the answer or what the user must decide. */
     detail: z.string(),
     /** Other records that appear to describe the same subject as match. Empty when none were found. */
     duplicate: z.array(IdentificationCandidateSchema),
-    /** Research request filed for the created record; absent without created, and when the record is already public. */
+    /** Research request filed for the created record; absent without created, when the lookup did not request research on it, and when the record is already public. */
     enrichmentRunId: z.uuid().nullish(),
     /** true when the match was settled on a second, slower review; confirm it before relying on it. Absent otherwise. */
     languageModelSettled: z.boolean().nullish(),
@@ -35,5 +36,7 @@ export const IdentificationSchema = z.object({
     officialUrl: z.string().nullish(),
     /** Use the scoped match, record scoped absence, or refine an ambiguous identity with evidence. */
     status: z.enum(["MATCHED", "NO_MATCH", "NEEDS_REVIEW"]),
+    /** Fresh backend URL evidence gathered when verifyUrl=true; empty otherwise. */
+    urlHostForm: z.array(UrlHostFormResolutionSchema),
 });
 //# sourceMappingURL=identification.js.map

package/dist/identification/subject.d.ts

@@ -22,6 +22,11 @@ export declare const IdentificationSubjectSchema: z.ZodObject<{
     location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    sourceIdentifier: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        idType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
     sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     typeRecord: z.ZodOptional<z.ZodNullable<z.ZodEnum<{

package/dist/identification/subject.js

@@ -1,6 +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";
 import { EntityTypeSchema } from "../entity/type.js";
+import { UniqueIdMutationSchema } from "../unique/id-mutation.js";
 /**
  * The company, Product, Service, or person to identify. Send the name, a URL it owns, or both, plus every location and source you have; a website or profile URL usually settles the answer without any model call.
  *
@@ -26,6 +27,8 @@ export const IdentificationSubjectSchema = z.object({
     name: z.string().max(200).nullish(),
     /** Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup. */
     providerId: z.uuid().nullish(),
+    /** Internal permanent Folk source identity. Requires private visibility and resolves before names or URLs. */
+    sourceIdentifier: UniqueIdMutationSchema.nullish(),
     /** aVenture news id of the article that mentions the subject; an unknown id is a 400. */
     sourceNewsId: z.int().nullish(),
     /** URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched. */

package/dist/lookup/job-mention.d.ts

@@ -1091,6 +1091,25 @@ declare const LookupJobMentionSchemaDefinition: z.ZodObject<{
             NEEDS_REVIEW: "NEEDS_REVIEW";
             NO_MATCH: "NO_MATCH";
         }>;
+        urlHostForm: z.ZodArray<z.ZodType<{
+            concluded: boolean;
+            crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+            crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+            landingHost?: string | null | undefined;
+            outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+            status?: string | null | undefined;
+            submittedUrl: string;
+            url: string;
+        }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput, z.core.$ZodTypeInternals<{
+            concluded: boolean;
+            crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+            crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+            landingHost?: string | null | undefined;
+            outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+            status?: string | null | undefined;
+            submittedUrl: string;
+            url: string;
+        }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput>>>;
     }, z.core.$strip>>>;
     mentionType: z.ZodEnum<{
         COMPANY: "COMPANY";

package/dist/lookup/job-mention.js

@@ -19,7 +19,7 @@ const LookupJobMentionSchemaDefinition = z.object({
     name: z.string(),
     /** POST /v1/lookup-mentions only: the candidate people as search results show them, ranked like entity. */
     person: z.array(PersonSchema),
-    /** New unpublished record aVenture created for a NO_MATCH name that the article and another live page both name. enrichmentRunId names the research already filed for it; to file research yourself, send its entityId to POST /v1/entities/{entityId}/enrichments or its personId to POST /v1/people/{personId}/enrichments. */
+    /** New unpublished record aVenture created, at no charge, for a NO_MATCH name whose own live site names it. enrichmentRunId names research filed for it, if any; to file research yourself, send its entityId to POST /v1/entities/{entityId}/enrichments or its personId to POST /v1/people/{personId}/enrichments. */
     shell: EntityPersonOwnerSchema.nullish(),
     /** Why no new record was created for this NO_MATCH name. */
     shellDetail: z.string().nullish(),

package/dist/lookup/job-mutation.d.ts

@@ -24,6 +24,11 @@ declare const LookupJobMutationSchemaDefinition: z.ZodObject<{
         location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        sourceIdentifier: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            idType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
         sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         typeRecord: z.ZodOptional<z.ZodNullable<z.ZodEnum<{

package/dist/lookup/job.d.ts

@@ -188,6 +188,25 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             NEEDS_REVIEW: "NEEDS_REVIEW";
             NO_MATCH: "NO_MATCH";
         }>;
+        urlHostForm: z.ZodArray<z.ZodType<{
+            concluded: boolean;
+            crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+            crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+            landingHost?: string | null | undefined;
+            outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+            status?: string | null | undefined;
+            submittedUrl: string;
+            url: string;
+        }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput, z.core.$ZodTypeInternals<{
+            concluded: boolean;
+            crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+            crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+            landingHost?: string | null | undefined;
+            outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+            status?: string | null | undefined;
+            submittedUrl: string;
+            url: string;
+        }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput>>>;
     }, z.core.$strip>>>;
     jobId: z.ZodUUID;
     limitReached: z.ZodBoolean;
@@ -757,6 +776,16 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             officialUrl?: string | null | undefined;
             status: "MATCHED" | "NEEDS_REVIEW" | "NO_MATCH";
+            urlHostForm: {
+                concluded: boolean;
+                crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+                crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+                landingHost?: string | null | undefined;
+                outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+                status?: string | null | undefined;
+                submittedUrl: string;
+                url: string;
+            }[];
         } | null | undefined;
         mentionType: "COMPANY" | "PERSON" | "PRODUCT_SERVICE";
         name: string;
@@ -1369,6 +1398,16 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             officialUrl?: string | null | undefined;
             status: "MATCHED" | "NEEDS_REVIEW" | "NO_MATCH";
+            urlHostForm: {
+                concluded: boolean;
+                crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+                crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+                landingHost?: string | null | undefined;
+                outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+                status?: string | null | undefined;
+                submittedUrl: string;
+                url: string;
+            }[];
         } | null | undefined;
         mentionType: "COMPANY" | "PERSON" | "PRODUCT_SERVICE";
         name: string;
@@ -1436,6 +1475,11 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             location?: string | null | undefined;
             name?: string | null | undefined;
             providerId?: string | null | undefined;
+            sourceIdentifier?: {
+                identifier?: string | null | undefined;
+                idType?: string | null | undefined;
+                source?: string | null | undefined;
+            } | null | undefined;
             sourceNewsId?: number | null | undefined;
             sourceUrl?: string | null | undefined;
             typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
@@ -1458,6 +1502,11 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             location?: string | null | undefined;
             name?: string | null | undefined;
             providerId?: string | null | undefined;
+            sourceIdentifier?: {
+                identifier?: string | null | undefined;
+                idType?: string | null | undefined;
+                source?: string | null | undefined;
+            } | null | undefined;
             sourceNewsId?: number | null | undefined;
             sourceUrl?: string | null | undefined;
             typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;

package/dist/mention/lookup.d.ts

@@ -565,6 +565,16 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             officialUrl?: string | null | undefined;
             status: "MATCHED" | "NEEDS_REVIEW" | "NO_MATCH";
+            urlHostForm: {
+                concluded: boolean;
+                crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+                crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+                landingHost?: string | null | undefined;
+                outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+                status?: string | null | undefined;
+                submittedUrl: string;
+                url: string;
+            }[];
         } | null | undefined;
         mentionType: "COMPANY" | "PERSON" | "PRODUCT_SERVICE";
         name: string;
@@ -1177,6 +1187,16 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             officialUrl?: string | null | undefined;
             status: "MATCHED" | "NEEDS_REVIEW" | "NO_MATCH";
+            urlHostForm: {
+                concluded: boolean;
+                crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+                crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+                landingHost?: string | null | undefined;
+                outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+                status?: string | null | undefined;
+                submittedUrl: string;
+                url: string;
+            }[];
         } | null | undefined;
         mentionType: "COMPANY" | "PERSON" | "PRODUCT_SERVICE";
         name: string;

package/dist/openapi-component-manifest.js

@@ -1003,6 +1003,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     SystemStatus: { modulePath: "system/status", schemaName: "SystemStatusSchema" },
     TextTypeOption: { modulePath: "text/type-option", schemaName: "TextTypeOptionSchema" },
     UniqueId: { modulePath: "unique/id", schemaName: "UniqueIdSchema" },
+    UniqueIdMutation: { modulePath: "unique/id-mutation", schemaName: "UniqueIdMutationSchema" },
     UniqueIdOwnerScope: {
         modulePath: "unique/id-owner-scope",
         schemaName: "UniqueIdOwnerScopeSchema",
@@ -1017,6 +1018,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "UrlDuplicateConflictSchema",
     },
     UrlDuplicateJoin: { modulePath: "url/duplicate-join", schemaName: "UrlDuplicateJoinSchema" },
+    UrlHostFormResolution: {
+        modulePath: "url/host-form-resolution",
+        schemaName: "UrlHostFormResolutionSchema",
+    },
     UrlMatchMode: { modulePath: "url/match-mode", schemaName: "UrlMatchModeSchema" },
     UrlTypeAlias: { modulePath: "url/type-alias", schemaName: "UrlTypeAliasSchema" },
     ValuationType: { modulePath: "valuation/type", schemaName: "ValuationTypeSchema" },

package/dist/problem/type.d.ts

@@ -18,6 +18,7 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     readonly INVALID_TOKEN: "https://api.aventure.vc/errors/invalid-token";
     readonly TOKEN_EXPIRED: "https://api.aventure.vc/errors/token-expired";
     readonly INVALID_AUTHENTICATION: "https://api.aventure.vc/errors/invalid-authentication";
+    readonly MALFORMED_TOKEN: "https://api.aventure.vc/errors/malformed-token";
     readonly CLIENT_CLOSED_REQUEST: "https://api.aventure.vc/errors/client-closed-request";
     readonly INVALID_JSON: "https://api.aventure.vc/errors/invalid-json";
     readonly METHOD_NOT_ALLOWED: "https://api.aventure.vc/errors/method-not-allowed";
@@ -77,6 +78,7 @@ export declare const ProblemTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         readonly INVALID_TOKEN: "https://api.aventure.vc/errors/invalid-token";
         readonly TOKEN_EXPIRED: "https://api.aventure.vc/errors/token-expired";
         readonly INVALID_AUTHENTICATION: "https://api.aventure.vc/errors/invalid-authentication";
+        readonly MALFORMED_TOKEN: "https://api.aventure.vc/errors/malformed-token";
         readonly CLIENT_CLOSED_REQUEST: "https://api.aventure.vc/errors/client-closed-request";
         readonly INVALID_JSON: "https://api.aventure.vc/errors/invalid-json";
         readonly METHOD_NOT_ALLOWED: "https://api.aventure.vc/errors/method-not-allowed";

package/dist/problem/type.js

@@ -10,6 +10,7 @@ const ProblemTypeSchemaKnownMembers = z.enum({
     INVALID_TOKEN: "https://api.aventure.vc/errors/invalid-token",
     TOKEN_EXPIRED: "https://api.aventure.vc/errors/token-expired",
     INVALID_AUTHENTICATION: "https://api.aventure.vc/errors/invalid-authentication",
+    MALFORMED_TOKEN: "https://api.aventure.vc/errors/malformed-token",
     CLIENT_CLOSED_REQUEST: "https://api.aventure.vc/errors/client-closed-request",
     INVALID_JSON: "https://api.aventure.vc/errors/invalid-json",
     METHOD_NOT_ALLOWED: "https://api.aventure.vc/errors/method-not-allowed",

package/dist/unique/id-mutation.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+/**
+ * Create or update payload for attaching an external identifier to an owner. For PATCH, omitted fields preserve their existing values and source may be explicitly cleared with null.
+ *
+ * @openapiSchema UniqueIdMutation
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
+ * @endpoint POST /v1/lookup-jobs
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
+ * @usedBySchema IdentificationSubjectSchema
+ * @contractShape unique.id-mutation
+ * @contractRole canonical
+ */
+export declare const UniqueIdMutationSchema: z.ZodObject<{
+    identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    idType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type UniqueIdMutation = z.infer<typeof UniqueIdMutationSchema>;
+//# sourceMappingURL=id-mutation.d.ts.map

package/dist/unique/id-mutation.js

@@ -0,0 +1,25 @@
+// 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";
+/**
+ * Create or update payload for attaching an external identifier to an owner. For PATCH, omitted fields preserve their existing values and source may be explicitly cleared with null.
+ *
+ * @openapiSchema UniqueIdMutation
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
+ * @endpoint POST /v1/lookup-jobs
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
+ * @usedBySchema IdentificationSubjectSchema
+ * @contractShape unique.id-mutation
+ * @contractRole canonical
+ */
+export const UniqueIdMutationSchema = z.object({
+    /** Identifier value as issued by the registry. */
+    identifier: z.string().nullish(),
+    /** Identifier type token, for example ein, secCik, or ticker. */
+    idType: z.string().nullish(),
+    /** Optional attribution source label for the mapping. */
+    source: z.string().nullish(),
+});
+//# sourceMappingURL=id-mutation.js.map

package/dist/unique/id-type.d.ts

@@ -1,6 +1,6 @@
 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.
+ * External identifier type that maps an owner to a registry id: ein, secCik, ticker, lei, duns, isin, cusip, crd, orcid, or folk.
  *
  * @openapiSchema UniqueIdType
  * @endpoint GET /v1/entities/lookup-exact
@@ -29,6 +29,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     cusip: "cusip";
     duns: "duns";
     ein: "ein";
+    folk: "folk";
     isin: "isin";
     lei: "lei";
     orcid: "orcid";
@@ -40,6 +41,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         cusip: "cusip";
         duns: "duns";
         ein: "ein";
+        folk: "folk";
         isin: "isin";
         lei: "lei";
         orcid: "orcid";

package/dist/unique/id-type.js

@@ -10,9 +10,10 @@ const UniqueIdTypeSchemaKnownMembers = z.enum([
     "cusip",
     "crd",
     "orcid",
+    "folk",
 ]);
 /**
- * External identifier type that maps an owner to a registry id: ein, secCik, ticker, lei, duns, isin, cusip, crd, or orcid.
+ * External identifier type that maps an owner to a registry id: ein, secCik, ticker, lei, duns, isin, cusip, crd, orcid, or folk.
  *
  * @openapiSchema UniqueIdType
  * @endpoint GET /v1/entities/lookup-exact

package/dist/unique/id.d.ts

@@ -8,6 +8,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
         cusip: "cusip";
         duns: "duns";
         ein: "ein";
+        folk: "folk";
         isin: "isin";
         lei: "lei";
         orcid: "orcid";
@@ -19,6 +20,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
             cusip: "cusip";
             duns: "duns";
             ein: "ein";
+            folk: "folk";
             isin: "isin";
             lei: "lei";
             orcid: "orcid";

package/dist/url/host-form-resolution.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod/v4";
+declare const UrlHostFormResolutionSchemaDefinition: z.ZodObject<{
+    concluded: z.ZodBoolean;
+    crawlCdnProvider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        akamai: "akamai";
+        awsCloudfront: "awsCloudfront";
+        azureCdn: "azureCdn";
+        bunny: "bunny";
+        cdn77: "cdn77";
+        cdnetworks: "cdnetworks";
+        cloudflare: "cloudflare";
+        digitalocean: "digitalocean";
+        fastly: "fastly";
+        gcore: "gcore";
+        googlecloudCdn: "googlecloudCdn";
+        incapsula: "incapsula";
+        keycdn: "keycdn";
+        leaseweb: "leaseweb";
+        netlify: "netlify";
+        none: "none";
+        stackpath: "stackpath";
+        sucuri: "sucuri";
+        unknown: "unknown";
+        vercel: "vercel";
+    }>>>;
+    crawlRenderMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        jsEnhanced: "jsEnhanced";
+        jsRequired: "jsRequired";
+        static: "static";
+    }>>>;
+    landingHost: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        noResponse: "noResponse";
+        refusal: "refusal";
+        rejection: "rejection";
+        success: "success";
+        transient: "transient";
+    }>>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    submittedUrl: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+type UrlHostFormResolutionDefinition = z.infer<typeof UrlHostFormResolutionSchemaDefinition>;
+export interface UrlHostFormResolutionSchemaInput extends z.input<typeof UrlHostFormResolutionSchemaDefinition> {
+}
+/**
+ * Fresh HTTP evidence and the preferred same-site host form of a submitted URL.
+ *
+ * @openapiSchema UrlHostFormResolution
+ * @endpoint GET /v1/lookup
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
+ * @usedBySchema IdentificationSchema
+ * @contractShape url.host-form-resolution
+ * @contractRole canonical
+ */
+export declare const UrlHostFormResolutionSchema: z.ZodType<UrlHostFormResolutionDefinition, UrlHostFormResolutionSchemaInput>;
+export type UrlHostFormResolution = z.infer<typeof UrlHostFormResolutionSchema>;
+export {};
+//# sourceMappingURL=host-form-resolution.d.ts.map

package/dist/url/host-form-resolution.js

@@ -0,0 +1,38 @@
+// 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 { EntityUrlCrawlCdnProviderSchema } from "../entity/url-crawl-cdn-provider.js";
+import { EntityUrlCrawlRenderModeSchema } from "../entity/url-crawl-render-mode.js";
+const UrlHostFormResolutionSchemaDefinition = z.object({
+    /** True only when live evidence landed on the submitted apex/www host pair, or the exact submitted host for URLs without that pair. */
+    concluded: z.boolean(),
+    /** Edge provider observed by this probe. */
+    crawlCdnProvider: EntityUrlCrawlCdnProviderSchema.nullish(),
+    /** Render requirement established from static and rendered readings of the same page. */
+    crawlRenderMode: EntityUrlCrawlRenderModeSchema.nullish(),
+    /** Host the live answer landed on after redirects; absent for other outcomes. */
+    landingHost: z.string().nullish(),
+    /** Typed outcome from the fresh probe; absent when no probe ran. */
+    outcome: z.enum(["success", "refusal", "rejection", "noResponse", "transient"]).nullish(),
+    /** Fresh HTTP status or classified probe result; absent for cached write normalization. */
+    status: z.string().nullish(),
+    /** The URL submitted for this probe. */
+    submittedUrl: z.string(),
+    /** Preferred same-site URL; submittedUrl when evidence is inconclusive. */
+    url: z.string(),
+});
+/**
+ * Fresh HTTP evidence and the preferred same-site host form of a submitted URL.
+ *
+ * @openapiSchema UrlHostFormResolution
+ * @endpoint GET /v1/lookup
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup
+ * @usedBySchema IdentificationSchema
+ * @contractShape url.host-form-resolution
+ * @contractRole canonical
+ */
+export const UrlHostFormResolutionSchema = UrlHostFormResolutionSchemaDefinition;
+//# sourceMappingURL=host-form-resolution.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.8.179",
+  "version": "0.8.181",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",