@aventurevc/api-schemas 0.8.334 → 0.8.336

package/dist/domain/conflict-type.d.ts

@@ -7,6 +7,7 @@ import { z } from "zod/v4";
  * @usedBySchema ClassificationInactiveTagDetailsSchema
  * @usedBySchema DomainConflictDetailsSchema
  * @usedBySchema DuplicateCreateReviewSchema
+ * @usedBySchema IdentificationSchema
  * @usedBySchema NewsSourceUrlConflictSchema
  * @usedBySchema StrictUrlLookupConflictSchema
  * @usedBySchema UrlDuplicateConflictSchema

package/dist/domain/conflict-type.js

@@ -15,6 +15,7 @@ const DomainConflictTypeSchemaKnownMembers = z.enum([
  * @usedBySchema ClassificationInactiveTagDetailsSchema
  * @usedBySchema DomainConflictDetailsSchema
  * @usedBySchema DuplicateCreateReviewSchema
+ * @usedBySchema IdentificationSchema
  * @usedBySchema NewsSourceUrlConflictSchema
  * @usedBySchema StrictUrlLookupConflictSchema
  * @usedBySchema UrlDuplicateConflictSchema

package/dist/identification/identification.d.ts

@@ -165,6 +165,21 @@ export declare const IdentificationSchema: z.ZodObject<{
         mode: z.ZodString;
         statusUrl: z.ZodString;
     }, z.core.$strip>>>;
+    filingRefusal: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        CLASSIFICATION_INACTIVE_TAG: "CLASSIFICATION_INACTIVE_TAG";
+        DUPLICATE_CREATE_REVIEW: "DUPLICATE_CREATE_REVIEW";
+        NEWS_SOURCE_URL: "NEWS_SOURCE_URL";
+        STRICT_URL_LOOKUP: "STRICT_URL_LOOKUP";
+        URL_DUPLICATE: "URL_DUPLICATE";
+    }>, z.ZodString]> & {
+        enum: {
+            CLASSIFICATION_INACTIVE_TAG: "CLASSIFICATION_INACTIVE_TAG";
+            DUPLICATE_CREATE_REVIEW: "DUPLICATE_CREATE_REVIEW";
+            NEWS_SOURCE_URL: "NEWS_SOURCE_URL";
+            STRICT_URL_LOOKUP: "STRICT_URL_LOOKUP";
+            URL_DUPLICATE: "URL_DUPLICATE";
+        };
+    }>>;
     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

@@ -1,5 +1,6 @@
 // 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 { DomainConflictTypeSchema } from "../domain/conflict-type.js";
 import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
 import { IdentificationCandidateSchema } from "./candidate.js";
 import { JobEnqueueSchema } from "../job/enqueue.js";
@@ -38,6 +39,8 @@ export const IdentificationSchema = z.object({
     enrichmentRunId: z.uuid().nullish(),
     /** Present only for callers that sent Prefer: respond-async. The identification is settled, but filing is pending. Poll statusUrl until the lookup job completes and use its identification; do not treat this as a final unfiled absence. */
     filing: JobEnqueueSchema.nullish(),
+    /** Conflict kind that refused creating the shell, from ProblemDetail.details.conflictType. Absent when no typed conflict refused filing; detail retains the explanation. */
+    filingRefusal: DomainConflictTypeSchema.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

@@ -1432,6 +1432,21 @@ declare const LookupJobMentionSchemaDefinition: z.ZodObject<{
             mode: z.ZodString;
             statusUrl: z.ZodString;
         }, z.core.$strip>>>;
+        filingRefusal: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            CLASSIFICATION_INACTIVE_TAG: "CLASSIFICATION_INACTIVE_TAG";
+            DUPLICATE_CREATE_REVIEW: "DUPLICATE_CREATE_REVIEW";
+            NEWS_SOURCE_URL: "NEWS_SOURCE_URL";
+            STRICT_URL_LOOKUP: "STRICT_URL_LOOKUP";
+            URL_DUPLICATE: "URL_DUPLICATE";
+        }>, z.ZodString]> & {
+            enum: {
+                CLASSIFICATION_INACTIVE_TAG: "CLASSIFICATION_INACTIVE_TAG";
+                DUPLICATE_CREATE_REVIEW: "DUPLICATE_CREATE_REVIEW";
+                NEWS_SOURCE_URL: "NEWS_SOURCE_URL";
+                STRICT_URL_LOOKUP: "STRICT_URL_LOOKUP";
+                URL_DUPLICATE: "URL_DUPLICATE";
+            };
+        }>>;
         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

@@ -155,6 +155,21 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             mode: z.ZodString;
             statusUrl: z.ZodString;
         }, z.core.$strip>>>;
+        filingRefusal: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            CLASSIFICATION_INACTIVE_TAG: "CLASSIFICATION_INACTIVE_TAG";
+            DUPLICATE_CREATE_REVIEW: "DUPLICATE_CREATE_REVIEW";
+            NEWS_SOURCE_URL: "NEWS_SOURCE_URL";
+            STRICT_URL_LOOKUP: "STRICT_URL_LOOKUP";
+            URL_DUPLICATE: "URL_DUPLICATE";
+        }>, z.ZodString]> & {
+            enum: {
+                CLASSIFICATION_INACTIVE_TAG: "CLASSIFICATION_INACTIVE_TAG";
+                DUPLICATE_CREATE_REVIEW: "DUPLICATE_CREATE_REVIEW";
+                NEWS_SOURCE_URL: "NEWS_SOURCE_URL";
+                STRICT_URL_LOOKUP: "STRICT_URL_LOOKUP";
+                URL_DUPLICATE: "URL_DUPLICATE";
+            };
+        }>>;
         inserted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         languageModelSettled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         match: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -970,6 +985,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
                 mode: string;
                 statusUrl: string;
             } | null | undefined;
+            filingRefusal?: string | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {
@@ -1805,6 +1821,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
                 mode: string;
                 statusUrl: string;
             } | null | undefined;
+            filingRefusal?: string | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {

package/dist/lookup/source-read-phase.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Observed article-reading activity; unknown future phases retain their supplied copy.
+ * Observed source-reading activity; unknown future phases retain their supplied copy.
  *
  * @openapiSchema LookupSourceReadPhase
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/lookup/source-read-phase.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 const LookupSourceReadPhaseSchemaKnownMembers = z.enum(["READING", "MATCHING"]);
 /**
- * Observed article-reading activity; unknown future phases retain their supplied copy.
+ * Observed source-reading activity; unknown future phases retain their supplied copy.
  *
  * @openapiSchema LookupSourceReadPhase
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/lookup/source-read.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Publisher context and honest reading activity for a shared-article lookup.
+ * Source context and honest reading activity for a shared article or profile.
  *
  * @openapiSchema LookupSourceRead
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/lookup/source-read.js

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 import { JobEnqueueSchema } from "../job/enqueue.js";
 import { LookupSourceReadPhaseSchema } from "./source-read-phase.js";
 /**
- * Publisher context and honest reading activity for a shared-article lookup.
+ * Source context and honest reading activity for a shared article or profile.
  *
  * @openapiSchema LookupSourceRead
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/mention/lookup.d.ts

@@ -745,6 +745,7 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
                 mode: string;
                 statusUrl: string;
             } | null | undefined;
+            filingRefusal?: string | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {
@@ -1580,6 +1581,7 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
                 mode: string;
                 statusUrl: string;
             } | null | undefined;
+            filingRefusal?: string | null | undefined;
             inserted?: boolean | null | undefined;
             languageModelSettled?: boolean | null | undefined;
             match?: {

package/dist/openapi-component-manifest.js

@@ -1318,6 +1318,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     UrlTypeAlias: { modulePath: "url/type-alias", schemaName: "UrlTypeAliasSchema" },
     ValuationType: { modulePath: "valuation/type", schemaName: "ValuationTypeSchema" },
     WebSearch: { modulePath: "web/search", schemaName: "WebSearchSchema" },
+    WebSearchCacheSource: {
+        modulePath: "web/search-cache-source",
+        schemaName: "WebSearchCacheSourceSchema",
+    },
     WebSearchProvider: { modulePath: "web/search-provider", schemaName: "WebSearchProviderSchema" },
     WebSearchRecency: { modulePath: "web/search-recency", schemaName: "WebSearchRecencySchema" },
     WriterAnalysisSection: {

package/dist/registry/filing.js

@@ -28,7 +28,7 @@ export const RegistryFilingSchema = z.object({
     nameFormer: z.array(z.string()).max(10).optional(),
     /** People the filing names: executive officers, directors, promoters. */
     person: z.array(RegistryFilingPersonSchema).max(100).optional(),
-    /** Registry ids the filing states, such as secCik, ein, or npi. A record holding the same id is strong evidence; a record holding a different id of the same type is a different filer and never matches. */
+    /** Registry ids the filing states, such as secCik, ein, or npi. A record holding the same non-EIN id is strong evidence; an EIN is a reported tax assertion, never independent identity evidence. Filing or claiming a source requires verified tax-owner evidence before any write; unresolved EINs return review. A record holding a different exclusive id of the same type is a different filer. */
     uniqueId: z.array(UniqueIdMutationSchema).max(5).optional(),
 });
 //# sourceMappingURL=filing.js.map

package/dist/search/search.d.ts

@@ -3,6 +3,10 @@ declare const SearchSchemaDefinition: z.ZodObject<{
     allowSuspectedShellStrip: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     bypassCache: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     cacheKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    cacheSource: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        ANY: "ANY";
+        PROVIDER: "PROVIDER";
+    }>>>;
     deep: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     deferredAiOverview: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/search/search.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 { EntityPersonOwnerSchema } from "../entity/person-owner.js";
+import { WebSearchCacheSourceSchema } from "../web/search-cache-source.js";
 import { WebSearchProviderSchema } from "../web/search-provider.js";
 import { WebSearchRecencySchema } from "../web/search-recency.js";
 const SearchSchemaDefinition = z.object({
@@ -10,6 +11,8 @@ const SearchSchemaDefinition = z.object({
     bypassCache: z.boolean().default(false).optional(),
     /** Stable lookup text for cache keying when generated search text varies between runs */
     cacheKey: z.string().nullish(),
+    /** Permit compatible cached results from ANY provider by default, or restrict to PROVIDER. The provider field independently selects live misses; bypassCache skips every provider's cache. document.provider identifies the serving source. */
+    cacheSource: WebSearchCacheSourceSchema.default("ANY").optional(),
     /** Deprecated alias for `provider: EXA_DEEP`; `true` with any other `provider` is refused with 400. */
     deep: z.boolean().default(false).optional(),
     /** Wait in-request for Google's AI Overview when Google defers it to a follow-up request, as it does for most company and person lookups: one extra SerpAPI search per overview not already stored. An explicit `true` also reruns a stored search older than SerpAPI's one-hour cache to get a fresh token (its one-minute overview token expired and the cache would return it unchanged). Without it, no deferred overview is fetched; one an earlier fetch stored still comes back at no extra cost. A fetch that returns no overview is not retried for six hours. An overview Google returns inline always comes back in `aiOverview` at no extra cost. Exa results never carry one. */

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Create or merge-patch an external identifier mapping. Omitted fields preserve existing values; listing qualifiers apply only to entity tickers.
+ * Create or merge-patch an external identifier mapping. Omitted fields preserve existing values; listing qualifiers apply only to entity tickers. A new or changed EIN requires independently verified tax-owner evidence; an unheld number or source label does not establish ownership. Unchanged bindings and label-only patches preserve the existing tax identity.
  *
  * @openapiSchema UniqueIdMutation
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/unique/id-mutation.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { UniqueIdListingStandingSchema } from "./id-listing-standing.js";
 /**
- * Create or merge-patch an external identifier mapping. Omitted fields preserve existing values; listing qualifiers apply only to entity tickers.
+ * Create or merge-patch an external identifier mapping. Omitted fields preserve existing values; listing qualifiers apply only to entity tickers. A new or changed EIN requires independently verified tax-owner evidence; an unheld number or source label does not establish ownership. Unchanged bindings and label-only patches preserve the existing tax identity.
  *
  * @openapiSchema UniqueIdMutation
  * @endpoint GET /v1/lookup-jobs/{jobId}

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

@@ -36,6 +36,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     ipedsUnitId: "ipedsUnitId";
     isin: "isin";
     lei: "lei";
+    naicCompanyCode: "naicCompanyCode";
     ncesLeaId: "ncesLeaId";
     ncesPssId: "ncesPssId";
     ncesSchoolId: "ncesSchoolId";
@@ -62,6 +63,7 @@ export declare const UniqueIdTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
         ipedsUnitId: "ipedsUnitId";
         isin: "isin";
         lei: "lei";
+        naicCompanyCode: "naicCompanyCode";
         ncesLeaId: "ncesLeaId";
         ncesPssId: "ncesPssId";
         ncesSchoolId: "ncesSchoolId";

package/dist/unique/id-type.js

@@ -21,6 +21,7 @@ const UniqueIdTypeSchemaKnownMembers = z.enum([
     "ncuaCharter",
     "rssd",
     "holdingCompanyRssd",
+    "naicCompanyCode",
     "signalNfxFirm",
     "signalNfxPerson",
     "signalNfxCompany",

package/dist/unique/id.d.ts

@@ -17,6 +17,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
         ipedsUnitId: "ipedsUnitId";
         isin: "isin";
         lei: "lei";
+        naicCompanyCode: "naicCompanyCode";
         ncesLeaId: "ncesLeaId";
         ncesPssId: "ncesPssId";
         ncesSchoolId: "ncesSchoolId";
@@ -43,6 +44,7 @@ declare const UniqueIdSchemaDefinition: z.ZodObject<{
             ipedsUnitId: "ipedsUnitId";
             isin: "isin";
             lei: "lei";
+            naicCompanyCode: "naicCompanyCode";
             ncesLeaId: "ncesLeaId";
             ncesPssId: "ncesPssId";
             ncesSchoolId: "ncesSchoolId";

package/dist/web/search-cache-source.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * ANY reuses a compatible cached web search from any provider, checking the selected provider first. PROVIDER restricts reuse to the selected live provider. Neither option changes bypassCache, which always fetches from the live provider.
+ *
+ * @openapiSchema WebSearchCacheSource
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSchema
+ * @contractShape web.search-cache-source
+ * @contractRole canonical
+ */
+export declare const WebSearchCacheSourceSchema: z.ZodEnum<{
+    ANY: "ANY";
+    PROVIDER: "PROVIDER";
+}>;
+export type WebSearchCacheSource = z.infer<typeof WebSearchCacheSourceSchema>;
+//# sourceMappingURL=search-cache-source.d.ts.map

package/dist/web/search-cache-source.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";
+/**
+ * ANY reuses a compatible cached web search from any provider, checking the selected provider first. PROVIDER restricts reuse to the selected live provider. Neither option changes bypassCache, which always fetches from the live provider.
+ *
+ * @openapiSchema WebSearchCacheSource
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSchema
+ * @contractShape web.search-cache-source
+ * @contractRole canonical
+ */
+export const WebSearchCacheSourceSchema = z.enum(["ANY", "PROVIDER"]);
+//# sourceMappingURL=search-cache-source.js.map

package/dist/web/search.d.ts

@@ -104,6 +104,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
+        cacheSource?: "ANY" | "PROVIDER" | undefined;
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
@@ -121,6 +122,7 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
+        cacheSource?: "ANY" | "PROVIDER" | undefined;
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;

package/package.json

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