@aventurevc/api-schemas 0.8.222 → 0.8.223

package/dist/agent/help.d.ts

@@ -2,11 +2,13 @@ import { z } from "zod/v4";
 declare const AgentHelpSchemaDefinition: z.ZodObject<{
     answer: z.ZodString;
     citation: z.ZodArray<z.ZodType<{
+        billingAccess?: "DAILY_ALLOWANCE" | "PAID_PLAN" | null | undefined;
         excerpt: string;
         sourceId: string;
         sourceType: string;
         sourceVersion?: string | null | undefined;
     }, import("../help/citation.ts").HelpCitationSchemaInput, z.core.$ZodTypeInternals<{
+        billingAccess?: "DAILY_ALLOWANCE" | "PAID_PLAN" | null | undefined;
         excerpt: string;
         sourceId: string;
         sourceType: string;
@@ -19,11 +21,13 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
     }>;
     resolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         candidate: z.ZodArray<z.ZodType<{
+            billingAccess?: "DAILY_ALLOWANCE" | "PAID_PLAN" | null | undefined;
             excerpt: string;
             sourceId: string;
             sourceType: string;
             sourceVersion?: string | null | undefined;
         }, import("../help/citation.ts").HelpCitationSchemaInput, z.core.$ZodTypeInternals<{
+            billingAccess?: "DAILY_ALLOWANCE" | "PAID_PLAN" | null | undefined;
             excerpt: string;
             sourceId: string;
             sourceType: string;

package/dist/billing/access-type.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * What a caller without a paid plan gets. `PAID_PLAN`: nothing; the operation answers 402 subscription_required until the caller subscribes. `DAILY_ALLOWANCE`: a free UTC-day allowance, then 402 subscription_required until it refills.
+ *
+ * @openapiSchema BillingAccessType
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpCitationSchema
+ * @contractShape billing.access-type
+ * @contractRole canonical
+ */
+export declare const BillingAccessTypeSchema: z.ZodEnum<{
+    DAILY_ALLOWANCE: "DAILY_ALLOWANCE";
+    PAID_PLAN: "PAID_PLAN";
+}>;
+export type BillingAccessType = z.infer<typeof BillingAccessTypeSchema>;
+//# sourceMappingURL=access-type.d.ts.map

package/dist/billing/access-type.js

@@ -0,0 +1,14 @@
+// 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";
+/**
+ * What a caller without a paid plan gets. `PAID_PLAN`: nothing; the operation answers 402 subscription_required until the caller subscribes. `DAILY_ALLOWANCE`: a free UTC-day allowance, then 402 subscription_required until it refills.
+ *
+ * @openapiSchema BillingAccessType
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpCitationSchema
+ * @contractShape billing.access-type
+ * @contractRole canonical
+ */
+export const BillingAccessTypeSchema = z.enum(["PAID_PLAN", "DAILY_ALLOWANCE"]);
+//# sourceMappingURL=access-type.js.map

package/dist/billing/catalog-plan.js

@@ -9,11 +9,11 @@ const BillingCatalogPlanSchemaDefinition = z.object({
     /** ISO 4217 currency code. */
     currency: z.string(),
     displayName: z.string(),
-    /** First invoice amount when an automatic, one-time Checkout offer is available; absent otherwise. Renewals use unitAmount. */
+    /** First invoice amount in currency minor units (USD cents) when an automatic, one-time Checkout offer is available; absent otherwise. Renewals use unitAmount. */
     introductoryAmount: z.number().int().nullish(),
     plan: BillingPlanTypeSchema,
     tier: z.enum(["ESSENTIAL", "PLUS", "PRO", "UNLIMITED"]),
-    /** Price per cadence in the currency's minor unit, such as cents. */
+    /** Price per cadence in currency minor units, not major units: USD cents (4900 means USD 49.00). */
     unitAmount: z.number().int(),
 });
 /**

package/dist/entity/list-filter.js

@@ -85,7 +85,7 @@ export const EntityListFilterSchema = z.strictObject({
     qualityGate: EntityListQualityGateSchema.optional(),
     /** Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean. */
     rankByProminence: z.boolean().nullish(),
-    /** Free-text semantic search phrase, this body's query text (there is no query field), such as "AI tools for dental clinics". To find one company by name, send entityName instead. Executable on POST /v1/entities/search; saved views persist it for replay. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching entity. */
+    /** Free-text semantic search phrase, this body's query text (there is no query field), such as "AI tools for dental clinics". To filter this search to companies by name, send this body's entityName field instead; to identify one record from a name, call lookupRecord (POST /v1/lookup) with name, which accepts no entityName. Executable on POST /v1/entities/search; saved views persist it for replay. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching entity. */
     semanticQuery: z.string().nullish(),
     /** Restrict results to entity slugs. */
     slug: z

package/dist/federated/search.d.ts

@@ -7110,12 +7110,14 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         profile: {
             currentCompany?: string | null | undefined;
             headline?: string | null | undefined;
+            id: string;
             location?: string | null | undefined;
             name: string;
             named: string;
             organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
             photoUrl?: string | null | undefined;
             profileUrl: string;
+            slug: string;
         }[];
         result: {
             content: {
@@ -7487,12 +7489,14 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         profile: {
             currentCompany?: string | null | undefined;
             headline?: string | null | undefined;
+            id: string;
             location?: string | null | undefined;
             name: string;
             named: string;
             organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
             photoUrl?: string | null | undefined;
             profileUrl: string;
+            slug: string;
         }[];
         result: {
             content: {

package/dist/help/citation.d.ts

@@ -1,5 +1,9 @@
 import { z } from "zod/v4";
 declare const HelpCitationSchemaDefinition: z.ZodObject<{
+    billingAccess: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        DAILY_ALLOWANCE: "DAILY_ALLOWANCE";
+        PAID_PLAN: "PAID_PLAN";
+    }>>>;
     excerpt: z.ZodString;
     sourceId: z.ZodString;
     sourceType: z.ZodUnion<readonly [z.ZodEnum<{

package/dist/help/citation.js

@@ -1,7 +1,10 @@
 // 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 { BillingAccessTypeSchema } from "../billing/access-type.js";
 import { HelpSourceTypeSchema } from "./source-type.js";
 const HelpCitationSchemaDefinition = z.object({
+    /** What a caller without a paid plan gets from the cited operation; absent when the operation needs no plan. A resolve for such a caller ranks PAID_PLAN candidates after the others. */
+    billingAccess: BillingAccessTypeSchema.nullish(),
     /** Verbatim excerpt from the cited document supporting the answer. */
     excerpt: z.string(),
     /** Stable id within the source type: an operationId, a skill/prompt name, a completion gate id, or a research detail type targetPath. */

package/dist/help/resolution.d.ts

@@ -11,11 +11,13 @@ import { z } from "zod/v4";
  */
 export declare const HelpResolutionSchema: z.ZodObject<{
     candidate: z.ZodArray<z.ZodType<{
+        billingAccess?: "DAILY_ALLOWANCE" | "PAID_PLAN" | null | undefined;
         excerpt: string;
         sourceId: string;
         sourceType: string;
         sourceVersion?: string | null | undefined;
     }, import("./citation.ts").HelpCitationSchemaInput, z.core.$ZodTypeInternals<{
+        billingAccess?: "DAILY_ALLOWANCE" | "PAID_PLAN" | null | undefined;
         excerpt: string;
         sourceId: string;
         sourceType: string;

package/dist/link/search.d.ts

@@ -3761,12 +3761,14 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;
+                id: string;
                 location?: string | null | undefined;
                 name: string;
                 named: string;
                 organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
                 photoUrl?: string | null | undefined;
                 profileUrl: string;
+                slug: string;
             }[];
             result: {
                 content: {
@@ -8415,12 +8417,14 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;
+                id: string;
                 location?: string | null | undefined;
                 name: string;
                 named: string;
                 organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
                 photoUrl?: string | null | undefined;
                 profileUrl: string;
+                slug: string;
             }[];
             result: {
                 content: {

package/dist/openapi-component-manifest.js

@@ -51,6 +51,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "auth/provider-catalog",
         schemaName: "AuthProviderCatalogSchema",
     },
+    BillingAccessType: { modulePath: "billing/access-type", schemaName: "BillingAccessTypeSchema" },
     BillingAdditionalUsage: {
         modulePath: "billing/additional-usage",
         schemaName: "BillingAdditionalUsageSchema",

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

@@ -639,21 +639,25 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
     profile: z.ZodArray<z.ZodType<{
         currentCompany?: string | null | undefined;
         headline?: string | null | undefined;
+        id: string;
         location?: string | null | undefined;
         name: string;
         named: string;
         organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
         photoUrl?: string | null | undefined;
         profileUrl: string;
+        slug: string;
     }, import("../search/person-profile.ts").SearchPersonProfileSchemaInput, z.core.$ZodTypeInternals<{
         currentCompany?: string | null | undefined;
         headline?: string | null | undefined;
+        id: string;
         location?: string | null | undefined;
         name: string;
         named: string;
         organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
         photoUrl?: string | null | undefined;
         profileUrl: string;
+        slug: string;
     }, import("../search/person-profile.ts").SearchPersonProfileSchemaInput>>>;
     result: z.ZodType<{
         content: {

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

@@ -9,7 +9,7 @@ const PersonNaturalSearchResultSchemaDefinition = z.object({
     interpretation: PersonSearchInterpretationSchema,
     /** Personal investment participation supporting the returned people. Firm portfolio activity is never attributed to employees. Empty for other question intents. */
     investment: z.array(SearchInvestmentSchema),
-    /** Public LinkedIn profiles a web search found for people the query names 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`. */
+    /** 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. */
     result: PageResultPersonSchema,

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

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 declare const SearchPersonProfileSchemaDefinition: z.ZodObject<{
     currentCompany: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     headline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodUUID;
     location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     named: z.ZodString;
@@ -12,12 +13,13 @@ declare const SearchPersonProfileSchemaDefinition: z.ZodObject<{
     }>>>;
     photoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     profileUrl: z.ZodString;
+    slug: z.ZodString;
 }, z.core.$strip>;
 type SearchPersonProfileDefinition = z.infer<typeof SearchPersonProfileSchemaDefinition>;
 export interface SearchPersonProfileSchemaInput extends z.input<typeof SearchPersonProfileSchemaDefinition> {
 }
 /**
- * Public LinkedIn profile a search found for a person the query names who has no directory record. It shows the profile's own header; it does not assert current employment.
+ * A person resolved or filed from a web-discovered LinkedIn profile. Every row links to its aVenture person page; the web header does not assert current employment.
  *
  * @openapiSchema SearchPersonProfile
  * @endpoint GET /v1/search/link

package/dist/search/person-profile.js

@@ -5,6 +5,8 @@ const SearchPersonProfileSchemaDefinition = z.object({
     currentCompany: z.string().nullish(),
     /** Profile headline as the web search index holds it; null when it has none. */
     headline: z.string().nullish(),
+    /** Canonical aVenture person id. */
+    id: z.uuid(),
     /** Profile location as the web search index holds it. */
     location: z.string().nullish(),
     /** Name on the profile. */
@@ -15,11 +17,16 @@ const SearchPersonProfileSchemaDefinition = z.object({
     organizationEvidence: z.enum(["headline", "profile", "none"]).nullish(),
     /** Headshot URL from aVenture's stored LinkedIn capture; null until one is stored or when the capture holds no usable headshot. */
     photoUrl: z.string().nullish(),
-    /** Canonical public LinkedIn profile URL. */
+    /** Canonical aVenture person page URL; never an external profile URL. */
     profileUrl: z.string(),
+    /** Canonical aVenture person slug. */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255),
 });
 /**
- * Public LinkedIn profile a search found for a person the query names who has no directory record. It shows the profile's own header; it does not assert current employment.
+ * A person resolved or filed from a web-discovered LinkedIn profile. Every row links to its aVenture person page; the web header does not assert current employment.
  *
  * @openapiSchema SearchPersonProfile
  * @endpoint GET /v1/search/link

package/dist/shared/search.d.ts

@@ -3772,12 +3772,14 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;
+                id: string;
                 location?: string | null | undefined;
                 name: string;
                 named: string;
                 organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
                 photoUrl?: string | null | undefined;
                 profileUrl: string;
+                slug: string;
             }[];
             result: {
                 content: {
@@ -8426,12 +8428,14 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
             profile: {
                 currentCompany?: string | null | undefined;
                 headline?: string | null | undefined;
+                id: string;
                 location?: string | null | undefined;
                 name: string;
                 named: string;
                 organizationEvidence?: "headline" | "none" | "profile" | null | undefined;
                 photoUrl?: string | null | undefined;
                 profileUrl: string;
+                slug: string;
             }[];
             result: {
                 content: {

package/package.json

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