@aventurevc/api-schemas 0.8.418 → 0.8.420

package/dist/agent/suggestion-list.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+declare const AgentSuggestionListSchemaDefinition: z.ZodObject<{
+    suggestion: z.ZodArray<z.ZodType<{
+        label: string;
+        question: string;
+    }, import("./suggestion.ts").AgentSuggestionSchemaInput, z.core.$ZodTypeInternals<{
+        label: string;
+        question: string;
+    }, import("./suggestion.ts").AgentSuggestionSchemaInput>>>;
+}, z.core.$strip>;
+type AgentSuggestionListDefinition = z.infer<typeof AgentSuggestionListSchemaDefinition>;
+export interface AgentSuggestionListSchemaInput extends z.input<typeof AgentSuggestionListSchemaDefinition> {
+}
+/**
+ * Prepared suggested-question buttons for the Agent tab. Empty when no recent public funding or news records qualify.
+ *
+ * @openapiSchema AgentSuggestionList
+ * @endpoint GET /v1/agent/suggestions
+ * @contractShape agent.suggestion-list
+ * @contractRole canonical
+ */
+export declare const AgentSuggestionListSchema: z.ZodType<AgentSuggestionListDefinition, AgentSuggestionListSchemaInput>;
+export type AgentSuggestionList = z.infer<typeof AgentSuggestionListSchema>;
+export {};
+//# sourceMappingURL=suggestion-list.d.ts.map

package/dist/agent/suggestion-list.js

@@ -0,0 +1,17 @@
+// 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 { AgentSuggestionSchema } from "./suggestion.js";
+const AgentSuggestionListSchemaDefinition = z.object({
+    /** Up to 12 label-and-question pairs, most recent funding first, then recent news. Empty is a normal response, not an error. */
+    suggestion: z.array(AgentSuggestionSchema),
+});
+/**
+ * Prepared suggested-question buttons for the Agent tab. Empty when no recent public funding or news records qualify.
+ *
+ * @openapiSchema AgentSuggestionList
+ * @endpoint GET /v1/agent/suggestions
+ * @contractShape agent.suggestion-list
+ * @contractRole canonical
+ */
+export const AgentSuggestionListSchema = AgentSuggestionListSchemaDefinition;
+//# sourceMappingURL=suggestion-list.js.map

package/dist/agent/suggestion.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const AgentSuggestionSchemaDefinition: z.ZodObject<{
+    label: z.ZodString;
+    question: z.ZodString;
+}, z.core.$strip>;
+type AgentSuggestionDefinition = z.infer<typeof AgentSuggestionSchemaDefinition>;
+export interface AgentSuggestionSchemaInput extends z.input<typeof AgentSuggestionSchemaDefinition> {
+}
+/**
+ * One suggested Agent-tab question: the button label plus the question sent when tapped.
+ *
+ * @openapiSchema AgentSuggestion
+ * @endpoint GET /v1/agent/suggestions
+ * @usedBySchema AgentSuggestionListSchema
+ * @contractShape agent.suggestion
+ * @contractRole canonical
+ */
+export declare const AgentSuggestionSchema: z.ZodType<AgentSuggestionDefinition, AgentSuggestionSchemaInput>;
+export type AgentSuggestion = z.infer<typeof AgentSuggestionSchema>;
+export {};
+//# sourceMappingURL=suggestion.d.ts.map

package/dist/agent/suggestion.js

@@ -0,0 +1,19 @@
+// 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 AgentSuggestionSchemaDefinition = z.object({
+    /** Short button text naming the company and its news hook. */
+    label: z.string(),
+    /** Question sent to the research agent when the button is tapped. */
+    question: z.string(),
+});
+/**
+ * One suggested Agent-tab question: the button label plus the question sent when tapped.
+ *
+ * @openapiSchema AgentSuggestion
+ * @endpoint GET /v1/agent/suggestions
+ * @usedBySchema AgentSuggestionListSchema
+ * @contractShape agent.suggestion
+ * @contractRole canonical
+ */
+export const AgentSuggestionSchema = AgentSuggestionSchemaDefinition;
+//# sourceMappingURL=suggestion.js.map

package/dist/entity/filter.js

@@ -74,7 +74,7 @@ export const EntityFilterSchema = z.strictObject({
     investorPopulation: z.boolean().nullish(),
     /** First letter of the display name. */
     letter: z.string().nullish(),
-    /** Geographic classification values. */
+    /** Markets served, not HQ or offices. */
     location: z.array(z.string()).optional(),
     /** Logo sort priority. */
     logoOption: EntityFilterLogoOptionSchema.optional(),

package/dist/entity/list-filter.js

@@ -70,7 +70,7 @@ export const EntityListFilterSchema = z.strictObject({
     investorPopulation: z.boolean().nullish(),
     /** First letter of the display name. */
     letter: z.string().nullish(),
-    /** Geographic classification values. */
+    /** Markets served, not HQ or offices. */
     location: z.array(z.string()).optional(),
     /** Logo sort priority. */
     logoOption: EntityFilterLogoOptionSchema.optional(),
@@ -94,7 +94,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 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. */
+    /** Free-text semantic search phrase, this body's query text (there is no query field), such as "AI tools for dental clinics". For an existing-record name read, send this body's entityName field instead, compare the returned candidates' identity fields and evidenced URLs, then read the confirmed id. Search results are candidates, not identity verdicts; an empty result means no visible match for those filters, not permission to file. Use universal lookup (POST /v1/lookup) only when its possible filing effect is intended; it accepts name, not 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/entity/research-public-source.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources, privacy, terms, or other legal pages, and, in public views, suppressed secondary sources such as data aggregators.
+ * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources and for privacy, terms, or other legal pages.
  *
  * @openapiSchema EntityResearchPublicSource
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/research-public-source.js

@@ -1,7 +1,7 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
 /**
- * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources, privacy, terms, or other legal pages, and, in public views, suppressed secondary sources such as data aggregators.
+ * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources and for privacy, terms, or other legal pages.
  *
  * @openapiSchema EntityResearchPublicSource
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/search-param.js

@@ -12,7 +12,7 @@ export const ENTITY_SEARCH_ENDPOINT = "/v1/entities/search";
  * @contractRole canonical
  */
 export const EntitySearchParamSchema = PageParamSchema.extend({
-    /** Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Private backlog filters retain the search's bounded total. Unsupported with semanticQuery. */
+    /** Return totalElements with empty content. With private visibility and backlog filters, without semanticQuery, 5001 means at least that many; lower totals are exact. The page empty flag describes content, not matches. Unsupported with cursor or includeFullDetail=true. */
     countOnly: z.boolean().optional(),
     /** Opaque entity cursor; reuse filters and sort. Cursor is unsupported with countOnly; semanticQuery depends on the endpoint. */
     cursor: z.string().optional(),

package/dist/identification/identification.d.ts

@@ -177,6 +177,21 @@ export declare const IdentificationSchema: z.ZodObject<{
         };
     }>>;
     filingRefusalDetail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    filingResolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        acceptedValue: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        action: z.ZodEnum<{
+            authenticate: "authenticate";
+            removeParameter: "removeParameter";
+            reviewCandidates: "reviewCandidates";
+            setField: "setField";
+            setParameter: "setParameter";
+            useEndpoint: "useEndpoint";
+        }>;
+        endpoint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fieldPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        parameter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        retryable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
     inserted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     languageModelSettled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     match: z.ZodOptional<z.ZodNullable<z.ZodObject<{

package/dist/identification/identification.js

@@ -4,6 +4,7 @@ import { DomainConflictTypeSchema } from "../domain/conflict-type.js";
 import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
 import { IdentificationCandidateSchema } from "./candidate.js";
 import { JobEnqueueSchema } from "../job/enqueue.js";
+import { ProblemResolutionSchema } from "../problem/resolution.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.
@@ -38,6 +39,8 @@ export const IdentificationSchema = z.object({
     filingRefusal: DomainConflictTypeSchema.nullish(),
     /** Reason that pre-insert validation refused filing; present for verified previews as well as filing requests when validation refuses the subject. Absent when validation admits it; a preview never creates a record or claims a source identifier. */
     filingRefusalDetail: z.string().nullish(),
+    /** The naming owner's typed correction for a refused verified preview or filing. Absent on older responses or when no correction was supplied; absence never permits a retry. */
+    filingResolution: ProblemResolutionSchema.nullish(),
     /** Present only for callers that sent Prefer: respond-async. For a completed filing job, whether that request inserted created. */
     inserted: z.boolean().nullish(),
     /** true when the match was settled on a second, slower review; confirm it before relying on it. Absent otherwise. */

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

@@ -1903,6 +1903,21 @@ declare const LookupJobMentionSchemaDefinition: z.ZodObject<{
             };
         }>>;
         filingRefusalDetail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        filingResolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            acceptedValue: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            action: z.ZodEnum<{
+                authenticate: "authenticate";
+                removeParameter: "removeParameter";
+                reviewCandidates: "reviewCandidates";
+                setField: "setField";
+                setParameter: "setParameter";
+                useEndpoint: "useEndpoint";
+            }>;
+            endpoint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            fieldPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            parameter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            retryable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$strip>>>;
         inserted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         languageModelSettled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         match: z.ZodOptional<z.ZodNullable<z.ZodObject<{

package/dist/lookup/job.d.ts

@@ -172,6 +172,21 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             };
         }>>;
         filingRefusalDetail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        filingResolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            acceptedValue: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            action: z.ZodEnum<{
+                authenticate: "authenticate";
+                removeParameter: "removeParameter";
+                reviewCandidates: "reviewCandidates";
+                setField: "setField";
+                setParameter: "setParameter";
+                useEndpoint: "useEndpoint";
+            }>;
+            endpoint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            fieldPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            parameter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            retryable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$strip>>>;
         inserted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         languageModelSettled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         match: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -1252,6 +1267,14 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             filingRefusal?: string | null | undefined;
             filingRefusalDetail?: string | null | undefined;
+            filingResolution?: {
+                acceptedValue?: string[] | null | undefined;
+                action: "authenticate" | "removeParameter" | "reviewCandidates" | "setField" | "setParameter" | "useEndpoint";
+                endpoint?: string | null | undefined;
+                fieldPath?: string | null | undefined;
+                parameter?: string | null | undefined;
+                retryable?: boolean | null | undefined;
+            } | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {
@@ -2369,6 +2392,14 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             filingRefusal?: string | null | undefined;
             filingRefusalDetail?: string | null | undefined;
+            filingResolution?: {
+                acceptedValue?: string[] | null | undefined;
+                action: "authenticate" | "removeParameter" | "reviewCandidates" | "setField" | "setParameter" | "useEndpoint";
+                endpoint?: string | null | undefined;
+                fieldPath?: string | null | undefined;
+                parameter?: string | null | undefined;
+                retryable?: boolean | null | undefined;
+            } | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {

package/dist/mention/lookup.d.ts

@@ -1011,6 +1011,14 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             filingRefusal?: string | null | undefined;
             filingRefusalDetail?: string | null | undefined;
+            filingResolution?: {
+                acceptedValue?: string[] | null | undefined;
+                action: "authenticate" | "removeParameter" | "reviewCandidates" | "setField" | "setParameter" | "useEndpoint";
+                endpoint?: string | null | undefined;
+                fieldPath?: string | null | undefined;
+                parameter?: string | null | undefined;
+                retryable?: boolean | null | undefined;
+            } | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {
@@ -2128,6 +2136,14 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
             } | null | undefined;
             filingRefusal?: string | null | undefined;
             filingRefusalDetail?: string | null | undefined;
+            filingResolution?: {
+                acceptedValue?: string[] | null | undefined;
+                action: "authenticate" | "removeParameter" | "reviewCandidates" | "setField" | "setParameter" | "useEndpoint";
+                endpoint?: string | null | undefined;
+                fieldPath?: string | null | undefined;
+                parameter?: string | null | undefined;
+                retryable?: boolean | null | undefined;
+            } | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {

package/dist/openapi-component-manifest.js

@@ -15,6 +15,11 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     AddressState: { modulePath: "address/state", schemaName: "AddressStateSchema" },
     AgentHelp: { modulePath: "agent/help", schemaName: "AgentHelpSchema" },
     AgentHelpQuestion: { modulePath: "agent/help-question", schemaName: "AgentHelpQuestionSchema" },
+    AgentSuggestion: { modulePath: "agent/suggestion", schemaName: "AgentSuggestionSchema" },
+    AgentSuggestionList: {
+        modulePath: "agent/suggestion-list",
+        schemaName: "AgentSuggestionListSchema",
+    },
     AgentTaskPreset: { modulePath: "agent/task-preset", schemaName: "AgentTaskPresetSchema" },
     AgentTaskPresetCatalog: {
         modulePath: "agent/task-preset-catalog",

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

@@ -25,7 +25,7 @@ export const PersonLookupExactParamSchema = z.object({
     maxAssociations: z.int().optional(),
     /** Group C — candidate lookup signal: loose name match (any of given/family/full). A name alone never resolves; combine it with other group-C signals or url. Mutually exclusive with id and slug. */
     nameAny: z.string().optional(),
-    /** Group C — candidate lookup signal: person full name. A name alone never resolves (404): pair it with other group-C signals (location, urlDomain) or url. To find a person by name, use lookupRecord with kind PERSON; for the people at a company, use listEntityPersonAssociations. Mutually exclusive with id and slug. */
+    /** Group C — candidate lookup signal: person full name. A name alone never resolves (404): pair it with other group-C signals (location, urlDomain) or url. To find an existing person by name, use searchPeople with personName, compare candidate identity fields, roles, and evidenced URLs, then read the confirmed id. Search results are candidates, not identity verdicts. Choose universal lookup only when its possible filing effect is intended. For the people at a company, use listEntityPersonAssociations. Mutually exclusive with id and slug. */
     nameFull: z.string().optional(),
     /** Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response. */
     permitMonogram: z.boolean().optional(),

package/dist/problem/resolution.d.ts

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  *
  * @openapiSchema ProblemResolution
  * @standardProblemResponse
+ * @usedBySchema IdentificationSchema
  * @usedBySchema ProblemDetailSchema
  * @contractShape problem.resolution
  * @contractRole canonical

package/dist/problem/resolution.js

@@ -5,6 +5,7 @@ import { z } from "zod/v4";
  *
  * @openapiSchema ProblemResolution
  * @standardProblemResponse
+ * @usedBySchema IdentificationSchema
  * @usedBySchema ProblemDetailSchema
  * @contractShape problem.resolution
  * @contractRole canonical

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

@@ -25,6 +25,7 @@ import { z } from "zod/v4";
  * @contractRole canonical
  */
 export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    australiaAbn: "australiaAbn";
     belgiumEnterpriseNumber: "belgiumEnterpriseNumber";
     brazilCnpj: "brazilCnpj";
     chinaUnifiedSocialCreditCode: "chinaUnifiedSocialCreditCode";
@@ -69,6 +70,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     vietnamTaxCode: "vietnamTaxCode";
 }>, z.ZodString]> & {
     enum: {
+        australiaAbn: "australiaAbn";
         belgiumEnterpriseNumber: "belgiumEnterpriseNumber";
         brazilCnpj: "brazilCnpj";
         chinaUnifiedSocialCreditCode: "chinaUnifiedSocialCreditCode";

package/dist/unique/id-type.js

@@ -8,6 +8,7 @@ const UniqueIdTypeSchemaKnownMembers = z.enum([
     "irelandCompanyNumber",
     "japanCryptoAssetExchangeRegistration",
     "ukraineEdrpou",
+    "australiaAbn",
     "franceSiren",
     "belgiumEnterpriseNumber",
     "chinaUnifiedSocialCreditCode",

package/dist/unique/id.d.ts

@@ -6,6 +6,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
     id: z.ZodInt;
     identifier: z.ZodString;
     idType: z.ZodUnion<readonly [z.ZodEnum<{
+        australiaAbn: "australiaAbn";
         belgiumEnterpriseNumber: "belgiumEnterpriseNumber";
         brazilCnpj: "brazilCnpj";
         chinaUnifiedSocialCreditCode: "chinaUnifiedSocialCreditCode";
@@ -50,6 +51,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
         vietnamTaxCode: "vietnamTaxCode";
     }>, z.ZodString]> & {
         enum: {
+            australiaAbn: "australiaAbn";
             belgiumEnterpriseNumber: "belgiumEnterpriseNumber";
             brazilCnpj: "brazilCnpj";
             chinaUnifiedSocialCreditCode: "chinaUnifiedSocialCreditCode";

package/package.json

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