@aventurevc/api-schemas 0.8.173 → 0.8.175

package/dist/person/search-param.js

@@ -18,8 +18,6 @@ export const PersonSearchParamSchema = PageParamSchema.extend({
     cursor: z.string().optional(),
     /** When true, sort people who have a photo before those who do not. */
     hasImageFirst: z.boolean().optional(),
-    /** Includes hidden, unverified, and not-yet-published records when the caller has private-visibility authority. Omit to use the caller's default visibility. */
-    includePrivate: z.boolean().optional(),
     /** When false, monogram fallback logos are stripped from the response. Defaults to true. */
     permitMonogram: z.boolean().optional(),
 });

package/dist/research/finding.d.ts

@@ -12,7 +12,7 @@ export interface ResearchFindingSchemaInput extends z.input<typeof ResearchFindi
  * One fact you researched, with the page and exact text that support it. The run checks the quote against the page before it writes the fact.
  *
  * @openapiSchema ResearchFinding
- * @endpoint POST /v1/harness/runs
+ * @endpoint POST /v1/research-runs
  * @usedBySchema HarnessRunCreateSchema
  * @contractShape research.finding
  * @contractRole canonical

package/dist/research/finding.js

@@ -14,7 +14,7 @@ const ResearchFindingSchemaDefinition = z.object({
  * One fact you researched, with the page and exact text that support it. The run checks the quote against the page before it writes the fact.
  *
  * @openapiSchema ResearchFinding
- * @endpoint POST /v1/harness/runs
+ * @endpoint POST /v1/research-runs
  * @usedBySchema HarnessRunCreateSchema
  * @contractShape research.finding
  * @contractRole canonical

package/dist/search/search.d.ts

@@ -3,7 +3,6 @@ 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>>;
-    catalogRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     deep: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     deferredAiOverview: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -20,13 +19,6 @@ declare const SearchSchemaDefinition: z.ZodObject<{
     }, z.core.$strip>>>;
     search: z.ZodString;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    tenant: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        development: "development";
-        production: "production";
-        staging: "staging";
-        unassigned: "unassigned";
-    }>>>;
-    tenantPolicyRevision: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;
 type SearchDefinition = z.infer<typeof SearchSchemaDefinition>;
 export interface SearchSchemaInput extends z.input<typeof SearchSchemaDefinition> {

package/dist/search/search.js

@@ -1,20 +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 { EntityPersonOwnerSchema } from "../entity/person-owner.js";
-import { HarnessRunEnvironmentSchema } from "../harness/run-environment.js";
 import { WebSearchProviderSchema } from "../web/search-provider.js";
 const SearchSchemaDefinition = z.object({
-    /** Allow intentional money-like text without a currency marker; prefer --from-file. */
+    /** Set true only when an unmarked amount in the search text is intentional. */
     allowSuspectedShellStrip: z.boolean().nullish(),
     /** Skip cache lookup and refresh from the search provider */
     bypassCache: z.boolean().default(false).optional(),
     /** Stable lookup text for cache keying when generated search text varies between runs */
     cacheKey: z.string().nullish(),
-    /** Server-selected search catalog revision. */
-    catalogRevision: z.int().nullish(),
     /** 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). With the flag false, a harness-run credential fetches from a live token only and never reruns a search. Without either, 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. */
+    /** 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. */
     deferredAiOverview: z.boolean().default(false).optional(),
     /** Search language code */
     language: z.string().nullish(),
@@ -24,16 +21,12 @@ const SearchSchemaDefinition = z.object({
     region: z.string().nullish(),
     /** Maximum number of normalized results to keep */
     resultLimit: z.int().nullish(),
-    /** Entity or person this search was retrieved for: its stored result lists under that subject (`GET /v1/research/source-documents?entityId=` or `?personId=`) on a fetch or a cache hit */
+    /** Company or person this search is about; the stored result is filed under that record on a fetch or a cache hit. */
     retrievedFor: EntityPersonOwnerSchema.nullish(),
     /** Search text sent to the upstream web search provider */
     search: z.string(),
-    /** Optional caller identity, up to 64 characters, persisted for source-document attribution and abuse triage. Agent requests derive `<agentModel>-<agentChassis>` from the validated provenance actor instead of this field. */
+    /** Optional label for the calling application, up to 64 characters, stored with the search for attribution and abuse review. */
     source: z.string().max(64).nullish(),
-    /** Server-selected deployment tenant. */
-    tenant: HarnessRunEnvironmentSchema.nullish(),
-    /** Server-selected tenant execution-policy revision. */
-    tenantPolicyRevision: z.int().nullish(),
 });
 /**
  * Live web search request with cache controls

package/dist/standardized/classification.d.ts

@@ -17,7 +17,7 @@ type StandardizedClassificationDefinition = z.infer<typeof StandardizedClassific
 export interface StandardizedClassificationSchemaInput extends z.input<typeof StandardizedClassificationSchemaDefinition> {
 }
 /**
- * Canonical standardized classification projection backed by res_classification_ref. Rows are join-existing-only; creatable is false until a taxonomy writer exists.
+ * Industry or ownership classification from a standard taxonomy such as NAICS, SIC, or ISIC, with its category, code, and hierarchy level.
  *
  * @openapiSchema StandardizedClassification
  * @endpoint GET /v1/entities

package/dist/standardized/classification.js

@@ -9,13 +9,13 @@ const StandardizedClassificationSchemaDefinition = z.object({
     creatable: z.boolean(),
     /** Registry row creation timestamp. */
     createdAt: z.iso.datetime({ offset: true }).nullish(),
-    /** Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. */
+    /** Id of this classification on the entity; null in catalog and search results. */
     entityClassificationId: z.int().nullish(),
-    /** Standardized classification registry id from res_classification_ref; use as EntityClassificationMutation.classificationId. */
+    /** Standardized classification id. */
     id: z.int(),
     /** Standardized reference rows are current by definition. */
     isCurrent: z.boolean().nullish(),
-    /** Entity join primary flag within this standardized category. */
+    /** Whether this is the entity's primary classification in this category. */
     isPrimary: z.boolean().nullish(),
     /** Hierarchy level when present. */
     level: z.int().nullish(),
@@ -27,7 +27,7 @@ const StandardizedClassificationSchemaDefinition = z.object({
     writable: z.boolean(),
 });
 /**
- * Canonical standardized classification projection backed by res_classification_ref. Rows are join-existing-only; creatable is false until a taxonomy writer exists.
+ * Industry or ownership classification from a standard taxonomy such as NAICS, SIC, or ISIC, with its category, code, and hierarchy level.
  *
  * @openapiSchema StandardizedClassification
  * @endpoint GET /v1/entities

package/dist/strict/url-lookup-conflict.d.ts

@@ -2,6 +2,13 @@ import { z } from "zod/v4";
 declare const StrictUrlLookupConflictSchemaDefinition: z.ZodObject<{
     candidateEntityId: z.ZodArray<z.ZodUUID>;
     candidatePersonId: z.ZodArray<z.ZodUUID>;
+    conflictType: z.ZodOptional<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]>>;
     hint: z.ZodString;
     normalizedUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     url: z.ZodString;

package/dist/strict/url-lookup-conflict.js

@@ -1,10 +1,13 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
+import { DomainConflictTypeSchema } from "../domain/conflict-type.js";
 const StrictUrlLookupConflictSchemaDefinition = z.object({
     /** Every entity id that currently owns the normalized URL. May be empty when the conflict is between persons; combined with candidatePersonId always > 1. */
     candidateEntityId: z.array(z.uuid()),
     /** Every person id that currently owns the normalized URL. May be empty when the conflict is between entities; combined with candidateEntityId always > 1. */
     candidatePersonId: z.array(z.uuid()),
+    /** Conflict kind that identifies this details shape. */
+    conflictType: DomainConflictTypeSchema.optional(),
     /** Human-readable hint describing which disambiguating query parameters to add. */
     hint: z.string(),
     /** Normalized URL match key the lookup resolved against. Null when normalization could not produce a stable key. */

package/dist/system/status.js

@@ -18,7 +18,7 @@ const SystemStatusSchemaDefinition = z.object({
     minimumMacosBuild: z.int().nullish(),
     /** Minimum supported App Store macOS marketing version; empty disables update enforcement */
     minimumMacosVersion: z.string().nullish(),
-    /** Short hash identifying the exact set of operations this deployment serves. A generated client stamps the same value from the OpenAPI document it was built from; an unequal value means the client catalog is stale. `vc.aventure.application.usecase.system.status.OperationInventory` owns how it is computed. */
+    /** Short hash identifying the exact set of operations this deployment serves. A generated client stamps the same value from the OpenAPI document it was built from; an unequal value means the client catalog is stale. */
     operationFingerprint: z.string(),
     /** Uptime SLA data from external uptime monitoring */
     uptime: UptimeSchema,

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

@@ -1,5 +1,12 @@
 import { z } from "zod/v4";
 declare const UrlDuplicateConflictSchemaDefinition: z.ZodObject<{
+    conflictType: z.ZodOptional<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]>>;
     existingJoin: z.ZodArray<z.ZodType<{
         owner: {
             entityId?: string | null | undefined;

package/dist/url/duplicate-conflict.js

@@ -1,8 +1,11 @@
 // 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 { UrlDuplicateJoinSchema } from "./duplicate-join.js";
 const UrlDuplicateConflictSchemaDefinition = z.object({
+    /** Conflict kind that identifies this details shape. */
+    conflictType: DomainConflictTypeSchema.optional(),
     /** Every current owner that already holds the normalized URL with this urlType. Non-empty when this conflict is emitted. */
     existingJoin: z.array(UrlDuplicateJoinSchema),
     /** True when URL fragment differences were ignored during duplicate matching (i.e., the conflict ignores everything after '#'). */

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

@@ -10,7 +10,7 @@ type UrlDuplicateJoinDefinition = z.infer<typeof UrlDuplicateJoinSchemaDefinitio
 export interface UrlDuplicateJoinSchemaInput extends z.input<typeof UrlDuplicateJoinSchemaDefinition> {
 }
 /**
- * URL ownership join row identifying which entity or person currently owns a normalized URL.
+ * Entity or person that currently owns a normalized URL.
  *
  * @openapiSchema UrlDuplicateJoin
  * @standardProblemResponse

package/dist/url/duplicate-join.js

@@ -4,11 +4,11 @@ import { EntityPersonOwnerSchema } from "../entity/person-owner.js";
 const UrlDuplicateJoinSchemaDefinition = z.object({
     /** Owner of the URL: either entityId or personId is populated depending on the owner kind. Use the populated id to read or update the owner's URL. */
     owner: EntityPersonOwnerSchema,
-    /** Internal URL row id (res_weburl.id) — opaque to API clients. */
+    /** Identifier of the existing URL record that already holds this address. */
     urlId: z.int(),
 });
 /**
- * URL ownership join row identifying which entity or person currently owns a normalized URL.
+ * Entity or person that currently owns a normalized URL.
  *
  * @openapiSchema UrlDuplicateJoin
  * @standardProblemResponse

package/dist/web/search.d.ts

@@ -94,7 +94,6 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
-        catalogRevision?: number | null | undefined;
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
@@ -107,13 +106,10 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         } | null | undefined;
         search: string;
         source?: string | null | undefined;
-        tenant?: "development" | "production" | "staging" | "unassigned" | null | undefined;
-        tenantPolicyRevision?: number | null | undefined;
     }, import("../search/search.ts").SearchSchemaInput, z.core.$ZodTypeInternals<{
         allowSuspectedShellStrip?: boolean | null | undefined;
         bypassCache?: boolean | undefined;
         cacheKey?: string | null | undefined;
-        catalogRevision?: number | null | undefined;
         deep?: boolean | undefined;
         deferredAiOverview?: boolean | undefined;
         language?: string | null | undefined;
@@ -126,8 +122,6 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         } | null | undefined;
         search: string;
         source?: string | null | undefined;
-        tenant?: "development" | "production" | "staging" | "unassigned" | null | undefined;
-        tenantPolicyRevision?: number | null | undefined;
     }, import("../search/search.ts").SearchSchemaInput>>;
     sportsResult: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         league: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/package.json

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

package/dist/datasource/data-source-type.d.ts

@@ -1,24 +0,0 @@
-import { z } from "zod/v4";
-/**
- * Full read/storage source type for field-level provenance rows. Write query parameters use DatasourceWritableDataSourceType.
- *
- * @openapiSchema DatasourceDataSourceType
- * @endpoint GET /v1/entities
- * @contractShape datasource.data-source-type
- * @contractRole canonical
- */
-export declare const DatasourceDataSourceTypeSchema: z.ZodEnum<{
-    api: "api";
-    aventureStaff: "aventureStaff";
-    blogArticle: "blogArticle";
-    firstPartyWebsite: "firstPartyWebsite";
-    import: "import";
-    llm: "llm";
-    manual: "manual";
-    newsArticle: "newsArticle";
-    relatedPartyWebsite: "relatedPartyWebsite";
-    requestChangeForm: "requestChangeForm";
-    thirdPartyWebsite: "thirdPartyWebsite";
-}>;
-export type DatasourceDataSourceType = z.infer<typeof DatasourceDataSourceTypeSchema>;
-//# sourceMappingURL=data-source-type.d.ts.map

package/dist/datasource/data-source-type.js

@@ -1,24 +0,0 @@
-// 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";
-/**
- * Full read/storage source type for field-level provenance rows. Write query parameters use DatasourceWritableDataSourceType.
- *
- * @openapiSchema DatasourceDataSourceType
- * @endpoint GET /v1/entities
- * @contractShape datasource.data-source-type
- * @contractRole canonical
- */
-export const DatasourceDataSourceTypeSchema = z.enum([
-    "requestChangeForm",
-    "newsArticle",
-    "blogArticle",
-    "firstPartyWebsite",
-    "relatedPartyWebsite",
-    "thirdPartyWebsite",
-    "llm",
-    "aventureStaff",
-    "api",
-    "manual",
-    "import",
-]);
-//# sourceMappingURL=data-source-type.js.map

package/dist/datasource/provenance-actor-type.d.ts

@@ -1,15 +0,0 @@
-import { z } from "zod/v4";
-/**
- * Actor boundary for a provenance write event
- *
- * @openapiSchema DatasourceProvenanceActorType
- * @endpoint POST /v1/web/search
- * @contractShape datasource.provenance-actor-type
- * @contractRole canonical
- */
-export declare const DatasourceProvenanceActorTypeSchema: z.ZodEnum<{
-    agent: "agent";
-    employee: "employee";
-}>;
-export type DatasourceProvenanceActorType = z.infer<typeof DatasourceProvenanceActorTypeSchema>;
-//# sourceMappingURL=provenance-actor-type.d.ts.map

package/dist/datasource/provenance-actor-type.js

@@ -1,12 +0,0 @@
-// 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";
-/**
- * Actor boundary for a provenance write event
- *
- * @openapiSchema DatasourceProvenanceActorType
- * @endpoint POST /v1/web/search
- * @contractShape datasource.provenance-actor-type
- * @contractRole canonical
- */
-export const DatasourceProvenanceActorTypeSchema = z.enum(["agent", "employee"]);
-//# sourceMappingURL=provenance-actor-type.js.map

package/dist/suppression/reason.d.ts

@@ -1,17 +0,0 @@
-import { z } from "zod/v4";
-/**
- * Why this record is suppressed: it stays hidden for good, and its stored facts (names, URLs, addresses, entity-person joins) block creating or showing the same subject again. placeholderContent: sample or boilerplate content, often AI-written template copy, presented as a real organization or person. deceptive: a profile built to mislead. privacyRequest: the person asked to be removed and not added again.
- *
- * @openapiSchema SuppressionReason
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/people
- * @contractShape suppression.reason
- * @contractRole canonical
- */
-export declare const SuppressionReasonSchema: z.ZodUnion<readonly [z.ZodEnum<{
-    deceptive: "deceptive";
-    placeholderContent: "placeholderContent";
-    privacyRequest: "privacyRequest";
-}>, z.ZodString]>;
-export type SuppressionReason = z.infer<typeof SuppressionReasonSchema>;
-//# sourceMappingURL=reason.d.ts.map

package/dist/suppression/reason.js

@@ -1,16 +0,0 @@
-// 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";
-/**
- * Why this record is suppressed: it stays hidden for good, and its stored facts (names, URLs, addresses, entity-person joins) block creating or showing the same subject again. placeholderContent: sample or boilerplate content, often AI-written template copy, presented as a real organization or person. deceptive: a profile built to mislead. privacyRequest: the person asked to be removed and not added again.
- *
- * @openapiSchema SuppressionReason
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/people
- * @contractShape suppression.reason
- * @contractRole canonical
- */
-export const SuppressionReasonSchema = z.union([
-    z.enum(["placeholderContent", "deceptive", "privacyRequest"]),
-    z.string(),
-]);
-//# sourceMappingURL=reason.js.map