@aventurevc/api-schemas 0.8.174 → 0.8.176

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

@@ -32,12 +32,12 @@ export interface EntityNameAliasEntityAliasTypeSchemaInput extends z.input<typeo
  * @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/name-alias-entity-alias-type.js

@@ -31,12 +31,12 @@ const EntityNameAliasEntityAliasTypeSchemaDefinition = 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}
  * @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/people-param.d.ts

@@ -15,7 +15,6 @@ export declare const EntityPeopleParamSchema: z.ZodObject<{
     sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     countOnly: z.ZodOptional<z.ZodBoolean>;
     includeAddress: z.ZodOptional<z.ZodBoolean>;
-    includePrivate: z.ZodOptional<z.ZodBoolean>;
     includeUrl: z.ZodOptional<z.ZodBoolean>;
     isCurrent: z.ZodOptional<z.ZodBoolean>;
     permitMonogram: z.ZodOptional<z.ZodBoolean>;

package/dist/entity/people-param.js

@@ -16,8 +16,6 @@ export const EntityPeopleParamSchema = PageParamSchema.extend({
     countOnly: z.boolean().optional(),
     /** Include person address records */
     includeAddress: z.boolean().optional(),
-    /** Includes associations on hidden entities when the caller has private-visibility authority. Omit to use the caller's default visibility. */
-    includePrivate: z.boolean().optional(),
     /** Include person URL records */
     includeUrl: z.boolean().optional(),
     /** Current association filter */

package/dist/entity/relationship.js

@@ -18,9 +18,9 @@ const EntityRelationshipSchemaDefinition = z.object({
     entity: EntitySchema,
     /** Integer entity_relationship.id row id, not an entity UUID */
     id: z.int().nullish(),
-    /** Current-state curation flag for this relationship row. Default relationship reads return only rows where isCurrent=true and isPrimary=true. */
+    /** Whether this relationship is current. Default relationship reads return only rows where isCurrent=true and isPrimary=true. */
     isCurrent: z.boolean().nullish(),
-    /** Primary/renderable curation flag for this relationship row. isCurrent=false or isPrimary=false hides the row from default relationship reads. */
+    /** Whether this relationship is the primary one shown. isCurrent=false or isPrimary=false hides the row from default relationship reads. */
     isPrimary: z.boolean().nullish(),
     /** Published page behind this relationship, read from the provenance event that wrote it; absent for internal sources. */
     publicSource: EntityResearchPublicSourceSchema.nullish(),
@@ -28,7 +28,7 @@ const EntityRelationshipSchemaDefinition = z.object({
     get relationship() {
         return z.array(EntityRelationshipSchemaDefinition);
     },
-    /** Canonical relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor. Similarity endpoint rows use stored relationship types when a curation row exists and calculated when the row comes from semantic/vector similarity. */
+    /** Canonical relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor. Similarity endpoint rows use the stored relationship type when one exists and calculated when the row comes from similarity alone. */
     relationshipType: z.string(),
     /** Canonical source entity UUID stored on the relationship row. Compare with the requested entity id and `/v1/entities/relationships/types` sourceRole/targetRole to orient directional relationships such as parent. */
     sourceEntityId: z.uuid().nullish(),

package/dist/entity/research-detail.d.ts

@@ -40,7 +40,7 @@ type EntityResearchDetailDefinition = z.infer<typeof EntityResearchDetailSchemaD
 export interface EntityResearchDetailSchemaInput extends z.input<typeof EntityResearchDetailSchemaDefinition> {
 }
 /**
- * Canonical research detail row for research.res_entity_detail
+ * Research detail record for an entity.
  *
  * @openapiSchema EntityResearchDetail
  * @endpoint GET /v1/entities

package/dist/entity/research-detail.js

@@ -26,7 +26,7 @@ const EntityResearchDetailSchemaDefinition = z.object({
     valueType: EntityResearchValueTypeSchema,
 });
 /**
- * Canonical research detail row for research.res_entity_detail
+ * Research detail record for an entity.
  *
  * @openapiSchema EntityResearchDetail
  * @endpoint GET /v1/entities

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

@@ -16,7 +16,6 @@ export declare const EntitySearchParamSchema: z.ZodObject<{
     countOnly: z.ZodOptional<z.ZodBoolean>;
     cursor: z.ZodOptional<z.ZodString>;
     includeFullDetail: z.ZodOptional<z.ZodBoolean>;
-    includePrivate: z.ZodOptional<z.ZodBoolean>;
     permitMonogram: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type EntitySearchParam = z.infer<typeof EntitySearchParamSchema>;

package/dist/entity/search-param.js

@@ -16,10 +16,8 @@ export const EntitySearchParamSchema = PageParamSchema.extend({
     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(),
-    /** Privileged read flag. Must be true to return the /v1/entities/detail payload. */
+    /** Set true to return each match as its full company detail record instead of the list row; responses are much larger. */
     includeFullDetail: z.boolean().optional(),
-    /** Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility. */
-    includePrivate: z.boolean().optional(),
     /** Allow generated monogram logos in results. */
     permitMonogram: z.boolean().optional(),
 });

package/dist/entity/sitemap.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/sitemap.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/tag.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical classification tag projection. Catalog/search responses describe registry tags; entity-classification responses include classificationId plus join state.
+ * Classification tag. Catalog and search responses describe the tag itself; entity classification responses also carry classificationId and the entity's current and primary flags.
  *
  * @openapiSchema EntityTag
  * @endpoint GET /v1/entities

package/dist/entity/tag.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { ClassificationSchema } from "../classification/classification.js";
 /**
- * Canonical classification tag projection. Catalog/search responses describe registry tags; entity-classification responses include classificationId plus join state.
+ * Classification tag. Catalog and search responses describe the tag itself; entity classification responses also carry classificationId and the entity's current and primary flags.
  *
  * @openapiSchema EntityTag
  * @endpoint GET /v1/entities
@@ -35,19 +35,19 @@ import { ClassificationSchema } from "../classification/classification.js";
  * @contractRole canonical
  */
 export const EntityTagSchema = z.intersection(ClassificationSchema, z.object({
-    /** Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. */
+    /** Canonical classification bucket key; `type` is the value tag search and the catalog accept. */
     bucket: z.string().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. */
     classificationId: z.int().nullish(),
     /** Whether this bucket permits creating missing values by type plus name. */
     creatable: z.boolean(),
-    /** Registry tag creation timestamp, not the entity join timestamp. */
+    /** Tag creation timestamp, not the time the entity received this tag. */
     createdAt: z.iso.datetime({ offset: true }).nullish(),
-    /** Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. */
+    /** Classification tag id. */
     id: z.int(),
-    /** Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. */
+    /** In catalog and search results, whether the tag is active; in entity classification responses, whether the classification is current for the entity. */
     isCurrent: z.boolean().nullish(),
-    /** Entity join primary flag within its bucket; null on catalog/tag discovery. */
+    /** Whether this is the entity's primary classification in its bucket; null in catalog and search results. */
     isPrimary: z.boolean().nullish(),
     /** Name */
     name: z.string().max(255),
@@ -59,7 +59,7 @@ export const EntityTagSchema = z.intersection(ClassificationSchema, z.object({
         .nullish(),
     /** Canonical tag classification type */
     type: z.string(),
-    /** Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. */
+    /** Tag update timestamp, not the time the entity's classification changed. */
     updatedAt: z.iso.datetime({ offset: true }).nullish(),
     /** Whether this existing tag can be joined through tagId. */
     writable: z.boolean(),

package/dist/entity/valuation-data-confidence.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Confidence tier stored verbatim in res_entity_detail.data_confidence.
+ * Confidence tier for this data point.
  *
  * @openapiSchema EntityValuationDataConfidence
  * @endpoint GET /v1/entities/{entityId}/employee-counts

package/dist/entity/valuation-data-confidence.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";
 /**
- * Confidence tier stored verbatim in res_entity_detail.data_confidence.
+ * Confidence tier for this data point.
  *
  * @openapiSchema EntityValuationDataConfidence
  * @endpoint GET /v1/entities/{entityId}/employee-counts

package/dist/federated/natural-search.js

@@ -5,15 +5,15 @@ import { ReasoningEffortSchema } from "../reasoning/effort.js";
 import { SearchCacheModeSchema } from "../search/cache-mode.js";
 import { SearchModeSchema } from "../search/mode.js";
 const FederatedNaturalSearchSchemaDefinition = z.object({
-    /** Optional chat model for the synthesis answer; null uses the catalog's search answer model. The same allowlist as `model` applies. The answer writes the page heading, title, and description, so this compares answer models without changing the catalog. */
+    /** Optional supported model for the written answer, which also supplies the page heading, title, and description. Omit it to use the default; an unsupported model answers 422. */
     answerModel: z.string().nullish(),
-    /** Search-stage cache policy. use reuses cached search work; bypass computes fresh without retaining outputs; refresh computes fresh and replaces normal entries. Record and immutable query-vector caches retain their own policy. Callers without private-data access always run use. */
+    /** Cache policy. use reuses earlier search work; bypass and refresh compute fresh results and are honored only for accounts with private-data access. */
     cacheMode: SearchCacheModeSchema.default("use").optional(),
     /** Explicit entity constraints for the entity scope only, as on POST /v1/search/natural/entities: caller-supplied fields override planner values. The person and news scopes ignore it. */
     entityFilter: EntityFilterSchema.optional(),
     /** Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). */
     mode: SearchModeSchema.default("auto").optional(),
-    /** Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted. */
+    /** Optional supported model for planning the search. Omit it to use the default; an unsupported model answers 422. */
     model: z.string().nullish(),
     /** News scope page size; omitted uses the size query parameter, under the same page-size cap. */
     newsSize: z.int().nullish(),
@@ -21,7 +21,7 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     personSize: z.int().nullish(),
     /** Plain-English search request. */
     query: z.string().min(1),
-    /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Callers without private-data access are capped at `medium`: an explicit value above it is lowered, and when it is null the resolved effort — the per-model default, the tier default, or, absent an app default, the gateway's own — is still bounded at `medium`. */
+    /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. */
     reasoningEffort: ReasoningEffortSchema.nullish(),
     /** Search catalog revision this search reads its qualifier prompts and startup vocabulary from, to compare catalog edits; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
     searchCatalogRevision: z.int().nullish(),

package/dist/harness/chassis.d.ts

@@ -3,11 +3,11 @@ import { z } from "zod/v4";
  * Agent loop a harness run executes on: the Claude Agent SDK or the Pi agent SDK
  *
  * @openapiSchema HarnessChassis
- * @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 HarnessRunSchema
  * @contractShape harness.chassis
  * @contractRole canonical

package/dist/harness/chassis.js

@@ -4,11 +4,11 @@ import { z } from "zod/v4";
  * Agent loop a harness run executes on: the Claude Agent SDK or the Pi agent SDK
  *
  * @openapiSchema HarnessChassis
- * @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 HarnessRunSchema
  * @contractShape harness.chassis
  * @contractRole canonical

package/dist/harness/llm-api.d.ts

@@ -3,11 +3,11 @@ import { z } from "zod/v4";
  * Gateway wire API for a run's LLM calls: Anthropic Messages, OpenAI Chat Completions, or OpenAI Responses
  *
  * @openapiSchema HarnessLlmApi
- * @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 HarnessRunSchema
  * @contractShape harness.llm-api
  * @contractRole canonical

package/dist/harness/llm-api.js

@@ -4,11 +4,11 @@ import { z } from "zod/v4";
  * Gateway wire API for a run's LLM calls: Anthropic Messages, OpenAI Chat Completions, or OpenAI Responses
  *
  * @openapiSchema HarnessLlmApi
- * @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 HarnessRunSchema
  * @contractShape harness.llm-api
  * @contractRole canonical

package/dist/harness/run-create.d.ts

@@ -28,7 +28,7 @@ export interface HarnessRunCreateSchemaInput extends z.input<typeof HarnessRunCr
  * Create one harness enrichment run
  *
  * @openapiSchema HarnessRunCreate
- * @endpoint POST /v1/harness/runs
+ * @endpoint POST /v1/research-runs
  * @contractShape harness.run-create
  * @contractRole canonical
  */

package/dist/harness/run-create.js

@@ -22,7 +22,7 @@ const HarnessRunCreateSchemaDefinition = z.object({
  * Create one harness enrichment run
  *
  * @openapiSchema HarnessRunCreate
- * @endpoint POST /v1/harness/runs
+ * @endpoint POST /v1/research-runs
  * @contractShape harness.run-create
  * @contractRole canonical
  */

package/dist/harness/run-detail.d.ts

@@ -172,10 +172,10 @@ type HarnessRunDetailDefinition = z.infer<typeof HarnessRunDetailSchemaDefinitio
 export interface HarnessRunDetailSchemaInput extends z.input<typeof HarnessRunDetailSchemaDefinition> {
 }
 /**
- * Harness run with its resolved public entity
+ * Research run with the profile it resolved to
  *
  * @openapiSchema HarnessRunDetail
- * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint GET /v1/research-runs/{runId}
  * @contractShape harness.run-detail
  * @contractRole canonical
  */

package/dist/harness/run-detail.js

@@ -4,22 +4,22 @@ import { EntitySchema } from "../entity/entity.js";
 import { HarnessRunProgressSchema } from "./run-progress.js";
 import { HarnessRunSchema } from "./run.js";
 const HarnessRunDetailSchemaDefinition = z.object({
-    /** Current public entity resolved from the run slug */
+    /** Current public profile the run resolved to */
     entity: EntitySchema.nullish(),
-    /** Parsed principal-facing loop progress; null when the raw run status is absent or invalid */
+    /** Latest research progress; null when none is available */
     latestStatus: HarnessRunProgressSchema.nullish(),
     /** Parent organization's core record when the resolved entity is a Product/Service; null for every other entity type */
     provider: EntitySchema.nullish(),
     /** Exact renderable public profile URL for the resolved entity */
     publicUrl: z.string().nullish(),
-    /** Canonical harness run */
+    /** The research run */
     run: HarnessRunSchema,
 });
 /**
- * Harness run with its resolved public entity
+ * Research run with the profile it resolved to
  *
  * @openapiSchema HarnessRunDetail
- * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint GET /v1/research-runs/{runId}
  * @contractShape harness.run-detail
  * @contractRole canonical
  */

package/dist/harness/run-environment.d.ts

@@ -3,15 +3,12 @@ import { z } from "zod/v4";
  * Owning API environment
  *
  * @openapiSchema HarnessRunEnvironment
- * @endpoint GET /v1/harness/runs/{runId}
- * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @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/web/search
+ * @endpoint POST /v1/research-runs
  * @usedBySchema HarnessRunSchema
- * @usedBySchema SearchSchema
  * @contractShape harness.run-environment
  * @contractRole canonical
  */

package/dist/harness/run-environment.js

@@ -4,15 +4,12 @@ import { z } from "zod/v4";
  * Owning API environment
  *
  * @openapiSchema HarnessRunEnvironment
- * @endpoint GET /v1/harness/runs/{runId}
- * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @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/web/search
+ * @endpoint POST /v1/research-runs
  * @usedBySchema HarnessRunSchema
- * @usedBySchema SearchSchema
  * @contractShape harness.run-environment
  * @contractRole canonical
  */

package/dist/harness/run-lane.d.ts

@@ -3,11 +3,11 @@ import { z } from "zod/v4";
  * Queue lane for admission priority: interactive client work vs background backlog
  *
  * @openapiSchema HarnessRunLane
- * @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 HarnessRunSchema
  * @contractShape harness.run-lane
  * @contractRole canonical

package/dist/harness/run-lane.js

@@ -4,11 +4,11 @@ import { z } from "zod/v4";
  * Queue lane for admission priority: interactive client work vs background backlog
  *
  * @openapiSchema HarnessRunLane
- * @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 HarnessRunSchema
  * @contractShape harness.run-lane
  * @contractRole canonical

package/dist/harness/run-progress.d.ts

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
  * Current public progress of a harness run
  *
  * @openapiSchema HarnessRunProgress
- * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint GET /v1/research-runs/{runId}
  * @usedBySchema HarnessRunDetailSchema
  * @contractShape harness.run-progress
  * @contractRole canonical

package/dist/harness/run-progress.js

@@ -4,7 +4,7 @@ import { z } from "zod/v4";
  * Current public progress of a harness run
  *
  * @openapiSchema HarnessRunProgress
- * @endpoint GET /v1/harness/runs/{runId}
+ * @endpoint GET /v1/research-runs/{runId}
  * @usedBySchema HarnessRunDetailSchema
  * @contractShape harness.run-progress
  * @contractRole canonical
@@ -18,7 +18,7 @@ export const HarnessRunProgressSchema = z.object({
         .regex(/^[a-z0-9_-]+$/)
         .max(255)
         .nullable(),
-    /** Concrete completion gates that remain unmet */
+    /** Profile sections the run has not finished yet */
     gateRemaining: z.array(z.string()),
     /** Optional progress note from the loop */
     note: z.string().nullish(),

package/dist/harness/run-status.d.ts

@@ -1,13 +1,13 @@
 import { z } from "zod/v4";
 /**
- * Harness run lifecycle state
+ * Research run lifecycle state
  *
  * @openapiSchema HarnessRunStatus
- * @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 HarnessRunSchema
  * @contractShape harness.run-status
  * @contractRole canonical

package/dist/harness/run-status.js

@@ -1,14 +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";
 /**
- * Harness run lifecycle state
+ * Research run lifecycle state
  *
  * @openapiSchema HarnessRunStatus
- * @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 HarnessRunSchema
  * @contractShape harness.run-status
  * @contractRole canonical

package/dist/harness/run-type.d.ts

@@ -1,13 +1,13 @@
 import { z } from "zod/v4";
 /**
- * Harness run kind: full enrichment loop or bounded micro-task
+ * Research run kind: a caller-filed research request or a narrower scheduled run
  *
  * @openapiSchema HarnessRunType
- * @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 HarnessRunSchema
  * @contractShape harness.run-type
  * @contractRole canonical

package/dist/harness/run-type.js

@@ -1,14 +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";
 /**
- * Harness run kind: full enrichment loop or bounded micro-task
+ * Research run kind: a caller-filed research request or a narrower scheduled run
  *
  * @openapiSchema HarnessRunType
- * @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 HarnessRunSchema
  * @contractShape harness.run-type
  * @contractRole canonical

package/dist/harness/run.d.ts

@@ -1,13 +1,13 @@
 import { z } from "zod/v4";
 /**
- * One harness enrichment run
+ * One research run on a company, Product, Service, or person
  *
  * @openapiSchema HarnessRun
- * @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 EnrichmentSchema
  * @usedBySchema HarnessRunDetailSchema
  * @contractShape harness.run