@aventurevc/api-schemas 0.8.174 → 0.8.176

package/dist/agent/help-question.d.ts

@@ -14,7 +14,7 @@ type AgentHelpQuestionDefinition = z.infer<typeof AgentHelpQuestionSchemaDefinit
 export interface AgentHelpQuestionSchemaInput extends z.input<typeof AgentHelpQuestionSchemaDefinition> {
 }
 /**
- * A natural-language question about how to operate the platform, answered from the operation catalog, agent skills, and completion gates.
+ * A plain-English question about how to use aVenture, answered with references to the operations that do it.
  *
  * @openapiSchema AgentHelpQuestion
  * @endpoint POST /v1/agents/help

package/dist/agent/help-question.js

@@ -2,19 +2,19 @@
 import { z } from "zod/v4";
 import { HelpScopeSchema } from "../help/scope.js";
 const AgentHelpQuestionSchemaDefinition = z.object({
-    /** False limits the help corpus to public operations and to catalog tasks whose every step is a public operation, the catalog a public build can run; true requires private-visibility authority; null uses the caller's own visibility. */
+    /** False limits answers to operations every account can run; omit it to match your account's access. */
     includePrivate: z.boolean().nullish(),
-    /** Optional chat model that answers the question; null uses the configured default. A caller without admin authority may only choose an allowlisted model; an ineligible model is rejected with 422. Admin callers are unrestricted. */
+    /** Optional supported model for the answer. Omit it to use the default; an unsupported model answers 422. */
     model: z.string().nullish(),
     /** The question to answer, in natural language. */
     question: z.string().max(2000),
-    /** True selects a catalog task or recommends an operation instead of composing an answer. Outcomes are TASK_PLAN, OPERATION_ADVICE, CLARIFY, or ABSTAIN. Resolve uses retrieval and a model decision, ignores model, and draws on its own per-caller limit instead of the answer quota. */
+    /** True recommends the operation or workflow that does what the question asks, or asks a clarifying question, instead of writing an answer. It ignores model and has its own per-account limit. */
     resolve: z.boolean().optional(),
     /** Optional scope restricting which operations the answer may recommend; null means all. */
     scope: HelpScopeSchema.nullish(),
 });
 /**
- * A natural-language question about how to operate the platform, answered from the operation catalog, agent skills, and completion gates.
+ * A plain-English question about how to use aVenture, answered with references to the operations that do it.
  *
  * @openapiSchema AgentHelpQuestion
  * @endpoint POST /v1/agents/help

package/dist/agent/help.d.ts

@@ -91,7 +91,7 @@ type AgentHelpDefinition = z.infer<typeof AgentHelpSchemaDefinition>;
 export interface AgentHelpSchemaInput extends z.input<typeof AgentHelpSchemaDefinition> {
 }
 /**
- * Grounded natural-language help answer with citations to specific operations, skills, or completion gates. Unsupported questions abstain (LOW confidence) rather than guess.
+ * Help answer with citations to the operations it draws on. Unsupported questions abstain (LOW confidence) rather than guess.
  *
  * @openapiSchema AgentHelp
  * @endpoint POST /v1/agents/help

package/dist/agent/help.js

@@ -14,7 +14,7 @@ const AgentHelpSchemaDefinition = z.object({
     resolution: HelpResolutionSchema.nullish(),
 });
 /**
- * Grounded natural-language help answer with citations to specific operations, skills, or completion gates. Unsupported questions abstain (LOW confidence) rather than guess.
+ * Help answer with citations to the operations it draws on. Unsupported questions abstain (LOW confidence) rather than guess.
  *
  * @openapiSchema AgentHelp
  * @endpoint POST /v1/agents/help

package/dist/classification/catalog-bucket.js

@@ -4,7 +4,7 @@ import { EntityTagSchema } from "../entity/tag.js";
 const ClassificationCatalogBucketSchemaDefinition = z.object({
     /** Other accepted spellings for this bucket (JSON key plus storage form, deduplicated against `type`). The /tags ?type= and /catalog ?bucketType= parameters accept any of `[type, ...alias]`. Empty when the bucket has only one canonical spelling. */
     alias: z.array(z.string()),
-    /** Canonical entity-classification bucket key. Use as EntityClassificationMutation.type when creating by type plus name. */
+    /** Canonical classification bucket key. */
     bucket: z.string().nullish(),
     /** Whether missing values in this bucket can be created by name. */
     creatable: z.boolean(),
@@ -12,7 +12,7 @@ const ClassificationCatalogBucketSchemaDefinition = z.object({
     hierarchical: z.boolean(),
     /** Human-readable bucket label (e.g. 'Revenue Model'). */
     label: z.string(),
-    /** Active registry tags only. Empty when includeTags=false; dormant tags are omitted and require write-time inactiveTagOverride recovery when type + name matches. */
+    /** Active tags only. Empty when includeTags=false. */
     tag: z.array(EntityTagSchema),
     /** Total active tags in this bucket. Populated regardless of `includeTags` so callers can decide whether to fetch detail without a follow-up count query. */
     tagCount: z.int(),

package/dist/classification/catalog.d.ts

@@ -114,7 +114,7 @@ type ClassificationCatalogDefinition = z.infer<typeof ClassificationCatalogSchem
 export interface ClassificationCatalogSchemaInput extends z.input<typeof ClassificationCatalogSchemaDefinition> {
 }
 /**
- * Full active entity classification taxonomy in one payload. Dormant registry tags are omitted from the catalog and surface through write-time 409 recovery instead.
+ * Full active entity classification taxonomy in one payload. Inactive tags are omitted.
  *
  * @openapiSchema ClassificationCatalog
  * @endpoint GET /v1/entities/classifications/catalog

package/dist/classification/catalog.js

@@ -12,7 +12,7 @@ const ClassificationCatalogSchemaDefinition = z.object({
     totalTag: z.int(),
 });
 /**
- * Full active entity classification taxonomy in one payload. Dormant registry tags are omitted from the catalog and surface through write-time 409 recovery instead.
+ * Full active entity classification taxonomy in one payload. Inactive tags are omitted.
  *
  * @openapiSchema ClassificationCatalog
  * @endpoint GET /v1/entities/classifications/catalog

package/dist/classification/inactive-tag-details.d.ts

@@ -4,6 +4,13 @@ declare const ClassificationInactiveTagDetailsSchemaDefinition: z.ZodObject<{
         ATTACH_INACTIVE: "ATTACH_INACTIVE";
         REACTIVATE: "REACTIVATE";
     }>>;
+    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]>>;
     slug: z.ZodString;
     tagId: z.ZodInt;
 }, z.core.$strip>;

package/dist/classification/inactive-tag-details.js

@@ -1,12 +1,15 @@
 // 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 { EntityClassificationInactiveTagOverrideSchema } from "../entity/classification-inactive-tag-override.js";
 const ClassificationInactiveTagDetailsSchemaDefinition = z.object({
     /** Allowed inactiveTagOverride values for this conflict */
     availableOverrides: z.array(EntityClassificationInactiveTagOverrideSchema),
+    /** Conflict kind that identifies this details shape. */
+    conflictType: DomainConflictTypeSchema.optional(),
     /** Existing dormant value slug or lookup key */
     slug: z.string(),
-    /** Existing tag id in res_type_ref */
+    /** Existing tag id */
     tagId: z.int(),
 });
 /**

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Polymorphic envelope for RFC 9457 ProblemDetail.details on HTTP 409 responses. The concrete variant depends on the conflict kind: URL ownership collisions return UrlDuplicateConflict; ambiguous strict URL lookups return StrictUrlLookupConflict; create-time duplicate review gates return DuplicateCreateReview; classification writes that touch an inactive tag bucket return ClassificationInactiveTagDetails; news publication+URL uniqueness violations return NewsSourceUrlConflict. Inspect ProblemDetail.code/type and the field set present on details to identify the variant.
+ * Details of an HTTP 409 conflict. conflictType names the shape: URL_DUPLICATE when the URL is already a current URL on another record; STRICT_URL_LOOKUP when an exact URL lookup matches more than one record; DUPLICATE_CREATE_REVIEW when a create or lookup returns candidate records to review; CLASSIFICATION_INACTIVE_TAG when a classification value exists but is inactive; NEWS_SOURCE_URL when another article already has the same publication and URL.
  *
  * @openapiSchema DomainConflictDetails
  * @standardProblemResponse
@@ -9,6 +9,7 @@ import { z } from "zod/v4";
  * @contractRole canonical
  */
 export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType<{
+    conflictType?: string | undefined;
     existingJoin: {
         owner: {
             entityId?: string | null | undefined;
@@ -26,6 +27,7 @@ export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType
     url: string;
     urlType: string;
 }, import("../url/duplicate-conflict.ts").UrlDuplicateConflictSchemaInput, z.core.$ZodTypeInternals<{
+    conflictType?: string | undefined;
     existingJoin: {
         owner: {
             entityId?: string | null | undefined;
@@ -45,6 +47,7 @@ export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType
 }, import("../url/duplicate-conflict.ts").UrlDuplicateConflictSchemaInput>>, z.ZodType<{
     candidateEntityId: string[];
     candidatePersonId: string[];
+    conflictType?: string | undefined;
     hint: string;
     normalizedUrl?: string | null | undefined;
     url: string;
@@ -52,6 +55,7 @@ export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType
 }, import("../strict/url-lookup-conflict.ts").StrictUrlLookupConflictSchemaInput, z.core.$ZodTypeInternals<{
     candidateEntityId: string[];
     candidatePersonId: string[];
+    conflictType?: string | undefined;
     hint: string;
     normalizedUrl?: string | null | undefined;
     url: string;
@@ -68,6 +72,7 @@ export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType
         slug?: string | null | undefined;
         typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
     }[] | null | undefined;
+    conflictType?: string | undefined;
     newsCandidate?: {
         externalId?: string | null | undefined;
         id: number;
@@ -89,6 +94,7 @@ export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType
         slug?: string | null | undefined;
         typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
     }[] | null | undefined;
+    conflictType?: string | undefined;
     newsCandidate?: {
         externalId?: string | null | undefined;
         id: number;
@@ -100,20 +106,24 @@ export declare const DomainConflictDetailsSchema: z.ZodUnion<readonly [z.ZodType
     threshold: number;
 }, import("../duplicate/create-review.ts").DuplicateCreateReviewSchemaInput>>, z.ZodType<{
     availableOverrides: ("ATTACH_INACTIVE" | "REACTIVATE")[];
+    conflictType?: string | undefined;
     slug: string;
     tagId: number;
 }, import("../classification/inactive-tag-details.ts").ClassificationInactiveTagDetailsSchemaInput, z.core.$ZodTypeInternals<{
     availableOverrides: ("ATTACH_INACTIVE" | "REACTIVATE")[];
+    conflictType?: string | undefined;
     slug: string;
     tagId: number;
 }, import("../classification/inactive-tag-details.ts").ClassificationInactiveTagDetailsSchemaInput>>, z.ZodType<{
     conflictingArticleId: number;
     conflictingArticleSlug: string;
     conflictingArticleTitle: string;
+    conflictType?: string | undefined;
 }, import("../news/source-url-conflict.ts").NewsSourceUrlConflictSchemaInput, z.core.$ZodTypeInternals<{
     conflictingArticleId: number;
     conflictingArticleSlug: string;
     conflictingArticleTitle: string;
+    conflictType?: string | undefined;
 }, import("../news/source-url-conflict.ts").NewsSourceUrlConflictSchemaInput>>]>;
 export type DomainConflictDetails = z.infer<typeof DomainConflictDetailsSchema>;
 //# sourceMappingURL=conflict-details.d.ts.map

package/dist/domain/conflict-details.js

@@ -6,7 +6,7 @@ import { NewsSourceUrlConflictSchema } from "../news/source-url-conflict.js";
 import { StrictUrlLookupConflictSchema } from "../strict/url-lookup-conflict.js";
 import { UrlDuplicateConflictSchema } from "../url/duplicate-conflict.js";
 /**
- * Polymorphic envelope for RFC 9457 ProblemDetail.details on HTTP 409 responses. The concrete variant depends on the conflict kind: URL ownership collisions return UrlDuplicateConflict; ambiguous strict URL lookups return StrictUrlLookupConflict; create-time duplicate review gates return DuplicateCreateReview; classification writes that touch an inactive tag bucket return ClassificationInactiveTagDetails; news publication+URL uniqueness violations return NewsSourceUrlConflict. Inspect ProblemDetail.code/type and the field set present on details to identify the variant.
+ * Details of an HTTP 409 conflict. conflictType names the shape: URL_DUPLICATE when the URL is already a current URL on another record; STRICT_URL_LOOKUP when an exact URL lookup matches more than one record; DUPLICATE_CREATE_REVIEW when a create or lookup returns candidate records to review; CLASSIFICATION_INACTIVE_TAG when a classification value exists but is inactive; NEWS_SOURCE_URL when another article already has the same publication and URL.
  *
  * @openapiSchema DomainConflictDetails
  * @standardProblemResponse

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

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+/**
+ * Conflict kind that identifies which details shape a 409 response carries.
+ *
+ * @openapiSchema DomainConflictType
+ * @standardProblemResponse
+ * @usedBySchema ClassificationInactiveTagDetailsSchema
+ * @usedBySchema DomainConflictDetailsSchema
+ * @usedBySchema DuplicateCreateReviewSchema
+ * @usedBySchema NewsSourceUrlConflictSchema
+ * @usedBySchema StrictUrlLookupConflictSchema
+ * @usedBySchema UrlDuplicateConflictSchema
+ * @contractShape domain.conflict-type
+ * @contractRole canonical
+ */
+export declare const DomainConflictTypeSchema: 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]>;
+export type DomainConflictType = z.infer<typeof DomainConflictTypeSchema>;
+//# sourceMappingURL=conflict-type.d.ts.map

package/dist/domain/conflict-type.js

@@ -0,0 +1,27 @@
+// 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";
+/**
+ * Conflict kind that identifies which details shape a 409 response carries.
+ *
+ * @openapiSchema DomainConflictType
+ * @standardProblemResponse
+ * @usedBySchema ClassificationInactiveTagDetailsSchema
+ * @usedBySchema DomainConflictDetailsSchema
+ * @usedBySchema DuplicateCreateReviewSchema
+ * @usedBySchema NewsSourceUrlConflictSchema
+ * @usedBySchema StrictUrlLookupConflictSchema
+ * @usedBySchema UrlDuplicateConflictSchema
+ * @contractShape domain.conflict-type
+ * @contractRole canonical
+ */
+export const DomainConflictTypeSchema = z.union([
+    z.enum([
+        "URL_DUPLICATE",
+        "STRICT_URL_LOOKUP",
+        "DUPLICATE_CREATE_REVIEW",
+        "CLASSIFICATION_INACTIVE_TAG",
+        "NEWS_SOURCE_URL",
+    ]),
+    z.string(),
+]);
+//# sourceMappingURL=conflict-type.js.map

package/dist/duplicate/create-review.d.ts

@@ -21,6 +21,13 @@ declare const DuplicateCreateReviewSchemaDefinition: z.ZodObject<{
         slug?: string | null | undefined;
         typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
     }, import("../search/duplicate-candidate-score.ts").SearchDuplicateCandidateScoreSchemaInput>>>>>;
+    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]>>;
     newsCandidate: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         externalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         id: z.ZodInt;

package/dist/duplicate/create-review.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";
 import { NewsCandidateScoreSchema } from "../news/candidate-score.js";
 import { SearchDuplicateCandidateScoreSchema } from "../search/duplicate-candidate-score.js";
 const DuplicateCreateReviewSchemaDefinition = z.object({
     /** Entity/person candidates returned by lookup or create duplicate review. If a candidate is the requested record, read/update that candidate by id. Create with duplicate override only after every candidate is reviewed as distinct. */
     candidate: z.array(SearchDuplicateCandidateScoreSchema).nullish(),
+    /** Conflict kind that identifies this details shape. */
+    conflictType: DomainConflictTypeSchema.optional(),
     /** News candidates returned by lookup or create duplicate review. If a candidate is the requested article, read/update that article by id. Otherwise block until source evidence proves a distinct article. */
     newsCandidate: z.array(NewsCandidateScoreSchema).nullish(),
     /** Create endpoint to retry only after reviewing the returned candidates and supplying overrideGate=duplicate and overrideReason as query parameters. Null for detail lookup ambiguity, where the next action is review/update/block. */

package/dist/enrichment/mode.d.ts

@@ -3,11 +3,11 @@ import { z } from "zod/v4";
  * Whether the run performs comprehensive enrichment or only selected tasks
  *
  * @openapiSchema EnrichmentMode
- * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
- * @endpoint POST /v1/harness/runs
  * @endpoint POST /v1/people/{personId}/enrichments
+ * @endpoint POST /v1/research-runs
  * @usedBySchema EnrichmentBatchSchema
  * @usedBySchema HarnessRunCreateSchema
  * @usedBySchema HarnessRunSchema

package/dist/enrichment/mode.js

@@ -4,11 +4,11 @@ import { z } from "zod/v4";
  * Whether the run performs comprehensive enrichment or only selected tasks
  *
  * @openapiSchema EnrichmentMode
- * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
- * @endpoint POST /v1/harness/runs
  * @endpoint POST /v1/people/{personId}/enrichments
+ * @endpoint POST /v1/research-runs
  * @usedBySchema EnrichmentBatchSchema
  * @usedBySchema HarnessRunCreateSchema
  * @usedBySchema HarnessRunSchema

package/dist/entity/alias-type.d.ts

@@ -21,12 +21,12 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
- * @endpoint GET /v1/harness/runs/{runId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}/related-entities
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/investments
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}

package/dist/entity/alias-type.js

@@ -22,12 +22,12 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
- * @endpoint GET /v1/harness/runs/{runId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}/related-entities
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/investments
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}

package/dist/entity/classification-suggestion.d.ts

@@ -62,7 +62,7 @@ type EntityClassificationSuggestionDefinition = z.infer<typeof EntityClassificat
 export interface EntityClassificationSuggestionSchemaInput extends z.input<typeof EntityClassificationSuggestionSchemaDefinition> {
 }
 /**
- * Ranked classification suggestion derived from the enriched entity profile and classification centroid embeddings. Returned by the default classification discovery endpoint before callers create source-backed classification joins.
+ * Ranked classification suggestion derived from the entity profile and classification embeddings.
  *
  * @openapiSchema EntityClassificationSuggestion
  * @endpoint GET /v1/entities/{entityId}/classifications/suggestions

package/dist/entity/classification-suggestion.js

@@ -3,9 +3,9 @@ import { z } from "zod/v4";
 import { EntityTagSchema } from "./tag.js";
 import { StandardizedClassificationSchema } from "../standardized/classification.js";
 const EntityClassificationSuggestionSchemaDefinition = z.object({
-    /** True when the entity already has a current or historical matching join. */
+    /** True when the entity already has this classification, current or historical. */
     alreadyJoined: z.boolean(),
-    /** Suggested writable editorial tag or standardized classification code candidate. */
+    /** Suggested classification tag or standardized classification code. */
     classification: z.union([EntityTagSchema, StandardizedClassificationSchema]),
     /** Whether a missing editorial tag value may be created with type plus name instead of tagId. */
     creatable: z.boolean(),
@@ -17,7 +17,7 @@ const EntityClassificationSuggestionSchemaDefinition = z.object({
     writable: z.boolean(),
 });
 /**
- * Ranked classification suggestion derived from the enriched entity profile and classification centroid embeddings. Returned by the default classification discovery endpoint before callers create source-backed classification joins.
+ * Ranked classification suggestion derived from the entity profile and classification embeddings.
  *
  * @openapiSchema EntityClassificationSuggestion
  * @endpoint GET /v1/entities/{entityId}/classifications/suggestions

package/dist/entity/classification.d.ts

@@ -266,7 +266,7 @@ type EntityClassificationDefinition = z.infer<typeof EntityClassificationSchemaD
 export interface EntityClassificationSchemaInput extends z.input<typeof EntityClassificationSchemaDefinition> {
 }
 /**
- * Entity classification join rows grouped by bucket; default reads include only current joins, and includeInactive=true adds inactive/historical joins.
+ * Entity classifications grouped by bucket. Reads return current classifications by default; includeInactive=true adds inactive and historical ones.
  *
  * @openapiSchema EntityClassification
  * @endpoint GET /v1/entities

package/dist/entity/classification.js

@@ -9,7 +9,7 @@ const EntityClassificationSchemaDefinition = z.object({
     industry: z.array(EntityTagSchema).default([]).optional(),
     /** Main product filter values */
     mainProduct: z.array(EntityTagSchema).default([]).optional(),
-    /** Standardized classification joins from res_classification_ref. Rows are join-existing-only and carry category/code metadata. */
+    /** Standardized taxonomy classifications such as NAICS, SIC, or ISIC codes, with category and code metadata. */
     standardizedClassification: z.array(StandardizedClassificationSchema).default([]).optional(),
     /** Tag filter values */
     tag: z.array(EntityTagSchema).default([]).optional(),
@@ -25,7 +25,7 @@ const EntityClassificationSchemaDefinition = z.object({
     typeTechnologyUsed: z.array(EntityTagSchema).default([]).optional(),
 });
 /**
- * Entity classification join rows grouped by bucket; default reads include only current joins, and includeInactive=true adds inactive/historical joins.
+ * Entity classifications grouped by bucket. Reads return current classifications by default; includeInactive=true adds inactive and historical ones.
  *
  * @openapiSchema EntityClassification
  * @endpoint GET /v1/entities

package/dist/entity/enrichment.js

@@ -7,7 +7,7 @@ import { EntityTextBundleSchema } from "./text-bundle.js";
 import { EntityUrlLinkSchema } from "./url-link.js";
 const EntityEnrichmentSchemaDefinition = z.object({
     address: z.array(AddressSchema),
-    /** Entity classification join projection for this read surface. Single-detail and full-detail batch reads include full history; list, default batch, and similar-entity reads may filter to current joins. Use GET /v1/entities/{entityId}/classifications?includeInactive=true for authoritative join history. */
+    /** Entity classifications. Single-detail and full-detail batch reads include history; list, default batch, and similar-entity reads may return only current classifications. Use GET /v1/entities/{entityId}/classifications?includeInactive=true for the full history. */
     classification: EntityClassificationSchema,
     fundingDetail: EntityFundingDetailSchema.nullish(),
     /** Address id of the current headquarters: the current dominant (operating) address; absent when none is on record, even when a domicile (legal seat) exists. Read this instead of the deprecated isHq flag, which marks the legal seat. */

package/dist/entity/entity.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Returned directly by GET /v1/sitemap/entities and the alphabetical (?letter=X) list. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
+ * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
  *
  * @openapiSchema Entity
  * @endpoint GET /v1/entities
@@ -21,12 +21,12 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
- * @endpoint GET /v1/harness/runs/{runId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}/related-entities
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/investments
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}

package/dist/entity/entity.js

@@ -5,7 +5,7 @@ import { EntityNameAliasEntityAliasTypeSchema } from "./name-alias-entity-alias-
 import { EntitySitemapSchema } from "./sitemap.js";
 import { EntityTypeSchema } from "./type.js";
 /**
- * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Returned directly by GET /v1/sitemap/entities and the alphabetical (?letter=X) list. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
+ * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
  *
  * @openapiSchema Entity
  * @endpoint GET /v1/entities
@@ -26,12 +26,12 @@ import { EntityTypeSchema } from "./type.js";
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
- * @endpoint GET /v1/harness/runs/{runId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}/related-entities
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/investments
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}

package/dist/entity/image.d.ts

@@ -31,7 +31,6 @@ export interface EntityImageSchemaInput extends z.input<typeof EntityImageSchema
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
- * @endpoint GET /v1/harness/runs/{runId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}/related-entities
  * @endpoint GET /v1/people/{personId}
@@ -40,6 +39,7 @@ export interface EntityImageSchemaInput extends z.input<typeof EntityImageSchema
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/investments
  * @endpoint GET /v1/people/{personId}/similar
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}

package/dist/entity/image.js

@@ -30,7 +30,6 @@ const EntityImageSchemaDefinition = z.object({
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
- * @endpoint GET /v1/harness/runs/{runId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}/related-entities
  * @endpoint GET /v1/people/{personId}
@@ -39,6 +38,7 @@ const EntityImageSchemaDefinition = z.object({
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/investments
  * @endpoint GET /v1/people/{personId}/similar
+ * @endpoint GET /v1/research-runs/{runId}
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}

package/dist/entity/investments-param.d.ts

@@ -16,7 +16,6 @@ export declare const EntityInvestmentsParamSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     dateFrom: z.ZodOptional<z.ZodISODate>;
     dateTo: z.ZodOptional<z.ZodISODate>;
-    includePrivate: z.ZodOptional<z.ZodBoolean>;
     latestPerEntity: z.ZodOptional<z.ZodBoolean>;
     maxAmount: z.ZodOptional<z.ZodNumber>;
     minAmount: z.ZodOptional<z.ZodNumber>;

package/dist/entity/investments-param.js

@@ -18,8 +18,6 @@ export const EntityInvestmentsParamSchema = PageParamSchema.extend({
     dateFrom: z.iso.date().optional(),
     /** Inclusive maximum announced date */
     dateTo: z.iso.date().optional(),
-    /** Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility. */
-    includePrivate: z.boolean().optional(),
     /** Return latest transaction per entity */
     latestPerEntity: z.boolean().optional(),
     /** Inclusive maximum amount raised. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings. */

package/dist/entity/investors-param.d.ts

@@ -13,8 +13,8 @@ export declare const EntityInvestorsParamSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodInt>;
     size: z.ZodOptional<z.ZodInt>;
     sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    compact: z.ZodOptional<z.ZodBoolean>;
     cursor: z.ZodOptional<z.ZodString>;
-    includePrivate: z.ZodOptional<z.ZodBoolean>;
     permitMonogram: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type EntityInvestorsParam = z.infer<typeof EntityInvestorsParamSchema>;

package/dist/entity/investors-param.js

@@ -12,10 +12,10 @@ export const ENTITY_INVESTORS_ENDPOINT = "/v1/entities/{entityId}/investors";
  * @contractRole canonical
  */
 export const EntityInvestorsParamSchema = PageParamSchema.extend({
+    /** Set true to return each investor's own profile with its people, news, funding rounds, relationships, and research as empty lists, not absent fields; the profile's sitemap flags still show which of them exist. Responses are much smaller. */
+    compact: z.boolean().optional(),
     /** Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort. */
     cursor: z.string().optional(),
-    /** Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility. */
-    includePrivate: z.boolean().optional(),
     /** Permit generated monogram fallback */
     permitMonogram: z.boolean().optional(),
 });

package/dist/entity/lookup-batch-param.d.ts

@@ -10,7 +10,6 @@ export declare const ENTITY_LOOKUP_BATCH_ENDPOINT: "/v1/entities/lookup-batch";
  * @contractRole canonical
  */
 export declare const EntityLookupBatchParamSchema: z.ZodObject<{
-    includePrivate: z.ZodOptional<z.ZodBoolean>;
     page: z.ZodOptional<z.ZodInt>;
     size: z.ZodOptional<z.ZodInt>;
 }, z.core.$strip>;

package/dist/entity/lookup-batch-param.js

@@ -11,8 +11,6 @@ export const ENTITY_LOOKUP_BATCH_ENDPOINT = "/v1/entities/lookup-batch";
  * @contractRole canonical
  */
 export const EntityLookupBatchParamSchema = z.object({
-    /** Includes hidden, unverified, and not-yet-published entities when the caller has private-visibility authority. Omit to use the caller's default visibility. */
-    includePrivate: z.boolean().optional(),
     /** Zero-based page index (0..N); omit page and size for the full batch. */
     page: z.int().optional(),
     /** The size of the page to be returned; omit page and size for the full batch. */

package/dist/entity/lookup-exact-param.d.ts

@@ -11,7 +11,6 @@ export declare const ENTITY_LOOKUP_EXACT_ENDPOINT: "/v1/entities/lookup-exact";
  */
 export declare const EntityLookupExactParamSchema: z.ZodObject<{
     companySlug: z.ZodOptional<z.ZodString>;
-    includePrivate: z.ZodOptional<z.ZodBoolean>;
     location: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     nameBrand: z.ZodOptional<z.ZodString>;

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

@@ -17,8 +17,6 @@ export const EntityLookupExactParamSchema = z.object({
         .regex(/^[a-z0-9_-]+$/)
         .max(255)
         .optional(),
-    /** Includes hidden or off-sitemap entities and hidden research snippets when the caller has private-visibility authority. */
-    includePrivate: z.boolean().optional(),
     /** Location candidate: city, state, or country. */
     location: z.string().optional(),
     /** Primary entity name candidate. */