@aventurevc/api-schemas 0.8.375 → 0.8.376

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

@@ -11,7 +11,7 @@ type EntityTypeAliasDefinition = z.infer<typeof EntityTypeAliasSchemaDefinition>
 export interface EntityTypeAliasSchemaInput extends z.input<typeof EntityTypeAliasSchemaDefinition> {
 }
 /**
- * Canonical EntityType value, accepted aliases, and public routing metadata.
+ * An entity type, its accepted alternative spellings, and how its public pages are addressed.
  *
  * @openapiSchema EntityTypeAlias
  * @endpoint GET /v1/entities/types

package/dist/entity/type-alias.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";
 const EntityTypeAliasSchemaDefinition = z.object({
-    /** Alias tokens accepted by EntityType.fromRaw (case-insensitive). */
+    /** Other spellings accepted for this entity type (case-insensitive). */
     alias: z.array(z.string()),
     /** Canonical EntityType value (e.g. "Company", "Investment Firm"). */
     canonical: z.string(),
@@ -15,7 +15,7 @@ const EntityTypeAliasSchemaDefinition = z.object({
     publicPathPrefix: z.string(),
 });
 /**
- * Canonical EntityType value, accepted aliases, and public routing metadata.
+ * An entity type, its accepted alternative spellings, and how its public pages are addressed.
  *
  * @openapiSchema EntityTypeAlias
  * @endpoint GET /v1/entities/types

package/dist/entity/type-group-membership.d.ts

@@ -20,7 +20,7 @@ type EntityTypeGroupMembershipDefinition = z.infer<typeof EntityTypeGroupMembers
 export interface EntityTypeGroupMembershipSchemaInput extends z.input<typeof EntityTypeGroupMembershipSchemaDefinition> {
 }
 /**
- * Canonical concrete entity types included by one entity type group.
+ * Entity types included in one entity type group.
  *
  * @openapiSchema EntityTypeGroupMembership
  * @endpoint GET /v1/entities/filters

package/dist/entity/type-group-membership.js

@@ -7,7 +7,7 @@ const EntityTypeGroupMembershipSchemaDefinition = z.object({
     typeRecord: z.array(EntityTypeSchema),
 });
 /**
- * Canonical concrete entity types included by one entity type group.
+ * Entity types included in one entity type group.
  *
  * @openapiSchema EntityTypeGroupMembership
  * @endpoint GET /v1/entities/filters

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical entity type groups for boundary-level scope selection.
+ * Groups of entity types, such as Organization, that a filter can select at once.
  *
  * @openapiSchema EntityTypeGroup
  * @endpoint GET /v1/entities/filters

package/dist/entity/type-group.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";
 /**
- * Canonical entity type groups for boundary-level scope selection.
+ * Groups of entity types, such as Organization, that a filter can select at once.
  *
  * @openapiSchema EntityTypeGroup
  * @endpoint GET /v1/entities/filters

package/dist/entity/type.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical entity classification for the organization, product, and service records stored in the entity domain.
+ * Kind of entity: an organization type such as Company or Investment Firm, or a Product or Service.
  *
  * @openapiSchema EntityType
  * @standardProblemResponse

package/dist/entity/type.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";
 /**
- * Canonical entity classification for the organization, product, and service records stored in the entity domain.
+ * Kind of entity: an organization type such as Company or Investment Firm, or a Product or Service.
  *
  * @openapiSchema EntityType
  * @standardProblemResponse

package/dist/entity/url-link.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Canonical URL link resource with owner, status, crawl, and source metadata. Lifecycle state (current vs former, primary vs secondary) is encoded by `isCurrent` and `isPrimary` — `urlType` is the canonical platform role only and write values come from GET /v1/url-types. Readers accept new platform roles as deployments evolve. To record a rebrand or domain migration, retain the prior URL with the same `urlType` (typically `website`) and set `isCurrent=false, isPrimary=false`; never encode lifecycle in the platform role.
+ * A URL linked to an entity or person, with its status, crawl results, and source. Lifecycle state (current vs former, primary vs secondary) is encoded by `isCurrent` and `isPrimary` — `urlType` names only the platform (website, linkedin, and so on), and its write values come from GET /v1/url-types. Readers accept new platform types as deployments evolve. To record a rebrand or domain migration, retain the prior URL with the same `urlType` (typically `website`) and set `isCurrent=false, isPrimary=false`; never encode lifecycle in the platform type.
  *
  * @openapiSchema EntityUrlLink
  * @endpoint GET /v1/entities/brand

package/dist/entity/url-link.js

@@ -5,7 +5,7 @@ import { EntityUrlCrawlCdnProviderSchema } from "./url-crawl-cdn-provider.js";
 import { EntityUrlCrawlRenderModeSchema } from "./url-crawl-render-mode.js";
 import { EntityUrlTypeSchema } from "./url-type.js";
 /**
- * Canonical URL link resource with owner, status, crawl, and source metadata. Lifecycle state (current vs former, primary vs secondary) is encoded by `isCurrent` and `isPrimary` — `urlType` is the canonical platform role only and write values come from GET /v1/url-types. Readers accept new platform roles as deployments evolve. To record a rebrand or domain migration, retain the prior URL with the same `urlType` (typically `website`) and set `isCurrent=false, isPrimary=false`; never encode lifecycle in the platform role.
+ * A URL linked to an entity or person, with its status, crawl results, and source. Lifecycle state (current vs former, primary vs secondary) is encoded by `isCurrent` and `isPrimary` — `urlType` names only the platform (website, linkedin, and so on), and its write values come from GET /v1/url-types. Readers accept new platform types as deployments evolve. To record a rebrand or domain migration, retain the prior URL with the same `urlType` (typically `website`) and set `isCurrent=false, isPrimary=false`; never encode lifecycle in the platform type.
  *
  * @openapiSchema EntityUrlLink
  * @endpoint GET /v1/entities/brand
@@ -68,7 +68,7 @@ export const EntityUrlLinkSchema = z.object({
     /** Time of the latest URL status observation. */
     statusChecked: z.iso.datetime({ offset: true }).nullish(),
     updatedAt: z.iso.datetime({ offset: true }).nullish(),
-    /** Canonical absolute URL after storage and live same-site host normalization. */
+    /** Absolute URL as stored, with the host normalized to the form the live site uses. */
     url: z.string(),
     urlType: EntityUrlTypeSchema,
 });

package/dist/entity/valuation-source.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Which canonical store the point came from.
+ * Where the point came from: a research detail or a funding round.
  *
  * @openapiSchema EntityValuationSource
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/valuation-source.js

@@ -1,7 +1,7 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
 /**
- * Which canonical store the point came from.
+ * Where the point came from: a research detail or a funding round.
  *
  * @openapiSchema EntityValuationSource
  * @endpoint GET /v1/entities/lookup-exact

package/dist/entity/valuation-time-series-point.js

@@ -15,7 +15,7 @@ const EntityValuationTimeSeriesPointSchemaDefinition = z.object({
     confidence: EntityValuationDataConfidenceSchema,
     /** ISO 4217 currency code. */
     currency: z.string(),
-    /** Exact source monetary decimal string for a research-detail valuation; legacy Long values are only projections. */
+    /** Valuation of a research detail exactly as the source states it, as a decimal string; the older whole-number value is only an approximation of it. */
     decimalValue: z.string().nullish(),
     /** Basis declared by the original source. */
     declaredBasis: ValuationTypeSchema,
@@ -29,7 +29,7 @@ const EntityValuationTimeSeriesPointSchemaDefinition = z.object({
     measurementBasis: z.string().nullish(),
     /** Source-stated reporting scope. */
     reportingScope: z.string().nullish(),
-    /** Canonical store that supplied the point. */
+    /** Where the point came from: a research detail or a funding round. */
     source: EntityValuationSourceSchema,
     /** `detail-<id>` or `fundraise-<transactionId>` display reference. */
     sourceRef: z.string(),

package/dist/federated/search-provenance.js

@@ -5,13 +5,13 @@ import { SearchModeExecutionSchema } from "../search/mode-execution.js";
 const FederatedSearchProvenanceSchemaDefinition = z.object({
     /** True when synthesis was requested but the answer model was temporarily unavailable (an upstream outage, open circuit, full concurrency limit, or expired deadline), so the entity scope carries no answer while every scope's rows returned, or when the answer check refused every paragraph the answer model drafted, so the answer has no paragraph. Retrying the same query may succeed. */
     answerUnavailable: z.boolean(),
-    /** Entity search strategy execution. */
+    /** Search method requested and used for entities. */
     entity: SearchModeExecutionSchema,
     /** Scopes whose required named subjects could not be resolved, or whose optional sources or candidate judgments did not all complete. Returned rows remain usable but the requested population is incomplete, so this response must not be cached as final. Clarifying the named subjects or retrying may complete these scopes. */
     incompleteScope: z.array(z.enum(["entity", "person", "news"])).optional(),
-    /** News search strategy execution. */
+    /** Search method requested and used for news. */
     news: SearchModeExecutionSchema,
-    /** Person search strategy execution. */
+    /** Search method requested and used for people. */
     person: SearchModeExecutionSchema,
     /** Scopes that rejected the query as unsearchable and returned an empty page while the other scopes ran; empty when every scope ran. */
     rejection: z.array(FederatedSearchRejectionSchema),

package/dist/federated/search.d.ts

@@ -14379,7 +14379,7 @@ type FederatedSearchDefinition = z.infer<typeof FederatedSearchSchemaDefinition>
 export interface FederatedSearchSchemaInput extends z.input<typeof FederatedSearchSchemaDefinition> {
 }
 /**
- * Federated entity, person, and news search result composed from each domain's canonical search result owner, with the strategy used for every scope.
+ * Combined entity, person, and news search results, each from that record type's own search, with the search method used for each.
  *
  * @openapiSchema FederatedSearch
  * @endpoint GET /v1/search/link

package/dist/federated/search.js

@@ -13,7 +13,7 @@ const FederatedSearchSchemaDefinition = z.object({
     entity: NaturalSearchResultSchema,
     /** Public detail for Product/Service rows on the entity result page, in search rank order. Other entity types are not hydrated. */
     entityDetail: z.array(EntityDetailSchema),
-    /** Canonical news page returned by the keyword list engine. */
+    /** Page of news results from keyword search. */
     news: PageResultNewsSchema,
     /** Public entities each news row on the page links to, in news page order; a row with no public entity link has no entry. */
     newsEntityMention: z.array(NewsEntityMentionSchema),
@@ -31,7 +31,7 @@ const FederatedSearchSchemaDefinition = z.object({
     section: z.array(z.enum(["person", "company", "productService", "investor"])).optional(),
 });
 /**
- * Federated entity, person, and news search result composed from each domain's canonical search result owner, with the strategy used for every scope.
+ * Combined entity, person, and news search results, each from that record type's own search, with the search method used for each.
  *
  * @openapiSchema FederatedSearch
  * @endpoint GET /v1/search/link

package/dist/fundraise/investment-evidence.d.ts

@@ -407,7 +407,7 @@ type FundraiseInvestmentEvidenceDefinition = z.infer<typeof FundraiseInvestmentE
 export interface FundraiseInvestmentEvidenceSchemaInput extends z.input<typeof FundraiseInvestmentEvidenceSchemaDefinition> {
 }
 /**
- * Canonical transaction, participation attribution, and their owning source metadata.
+ * A funding round, the investor's part in it, and the sources for each.
  *
  * @openapiSchema FundraiseInvestmentEvidence
  * @endpoint GET /v1/search/link

package/dist/fundraise/investment-evidence.js

@@ -13,7 +13,7 @@ const FundraiseInvestmentEvidenceSchemaDefinition = z.object({
     investorJoinSource: DatasourceSourceMetadataSchema.nullish(),
 });
 /**
- * Canonical transaction, participation attribution, and their owning source metadata.
+ * A funding round, the investor's part in it, and the sources for each.
  *
  * @openapiSchema FundraiseInvestmentEvidence
  * @endpoint GET /v1/search/link

package/dist/github/repo.js

@@ -4,7 +4,7 @@ const GithubRepoSchemaDefinition = z.object({
     createdAt: z.iso.datetime({ offset: true }).nullish(),
     description: z.string().nullish(),
     forkCount: z.int(),
-    /** GitHub's stable numeric repository id; sync upsert key per owner */
+    /** GitHub's stable numeric repository id; each sync uses it to match and update the owner's repository record */
     githubId: z.number().int(),
     /** Project homepage URL declared on the repository */
     homepageUrl: z.string().nullish(),

package/dist/harness/chassis.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Agent loop a harness run executes on: the Claude Agent SDK or the Pi agent SDK
+ * Agent framework a research run executes on: the Claude Agent SDK or the Pi agent SDK
  *
  * @openapiSchema HarnessChassis
  * @endpoint GET /v1/research/runs

package/dist/harness/chassis.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";
 /**
- * Agent loop a harness run executes on: the Claude Agent SDK or the Pi agent SDK
+ * Agent framework a research run executes on: the Claude Agent SDK or the Pi agent SDK
  *
  * @openapiSchema HarnessChassis
  * @endpoint GET /v1/research/runs

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Gateway wire API for a run's LLM calls: Anthropic Messages, OpenAI Chat Completions, or OpenAI Responses
+ * Language-model API format a run's calls use: Anthropic Messages, OpenAI Chat Completions, or OpenAI Responses
  *
  * @openapiSchema HarnessLlmApi
  * @endpoint GET /v1/research/runs

package/dist/harness/llm-api.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";
 /**
- * Gateway wire API for a run's LLM calls: Anthropic Messages, OpenAI Chat Completions, or OpenAI Responses
+ * Language-model API format a run's calls use: Anthropic Messages, OpenAI Chat Completions, or OpenAI Responses
  *
  * @openapiSchema HarnessLlmApi
  * @endpoint GET /v1/research/runs

package/dist/harness/research-outcome.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Unsuccessful direct-session research disposition
+ * How unsuccessful research ended: PARTIAL (some of it finished) or BLOCKED
  *
  * @openapiSchema HarnessResearchOutcome
  * @endpoint GET /v1/research/runs

package/dist/harness/research-outcome.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 const HarnessResearchOutcomeSchemaKnownMembers = z.enum(["PARTIAL", "BLOCKED"]);
 /**
- * Unsuccessful direct-session research disposition
+ * How unsuccessful research ended: PARTIAL (some of it finished) or BLOCKED
  *
  * @openapiSchema HarnessResearchOutcome
  * @endpoint GET /v1/research/runs

package/dist/harness/run-detail.js

@@ -7,7 +7,7 @@ import { HarnessRunSchema } from "./run.js";
 const HarnessRunDetailSchemaDefinition = z.object({
     /** Current public profile the run resolved to */
     entity: EntitySchema.nullish(),
-    /** Follow-up admission and direct child run ids for this terminal generation */
+    /** Follow-up runs filed when this run last finished, and their ids */
     followUp: HarnessRunFollowUpSchema.optional(),
     /** Time the run's newest stream event was recorded; null when the run has no events. A running run whose value stops advancing has stalled */
     lastEventAt: z.iso.datetime({ offset: true }).nullish(),

package/dist/harness/run-event.js

@@ -5,7 +5,7 @@ const HarnessRunEventSchemaDefinition = z.object({
     createdAt: z.iso.datetime({ offset: true }),
     /** Monotonic event id */
     id: z.number().int(),
-    /** Run-stream envelope as an opaque JSON string */
+    /** The full stream event as a JSON string */
     payload: z.string(),
     /** Owning run id */
     runId: z.uuid(),

package/dist/harness/run-follow-up-admission.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Durable admission state for one terminal run generation's follow-up work
+ * Whether the follow-up runs requested when this run last finished have all been filed
  *
  * @openapiSchema HarnessRunFollowUpAdmission
  * @endpoint GET /v1/research/runs

package/dist/harness/run-follow-up-admission.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";
 /**
- * Durable admission state for one terminal run generation's follow-up work
+ * Whether the follow-up runs requested when this run last finished have all been filed
  *
  * @openapiSchema HarnessRunFollowUpAdmission
  * @endpoint GET /v1/research/runs

package/dist/harness/run-follow-up.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Durable completion barrier and direct child run ids
+ * Follow-up runs this run started, and whether all of them have been filed
  *
  * @openapiSchema HarnessRunFollowUp
  * @endpoint GET /v1/research/runs/{runId}

package/dist/harness/run-follow-up.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { HarnessRunFollowUpAdmissionSchema } from "./run-follow-up-admission.js";
 /**
- * Durable completion barrier and direct child run ids
+ * Follow-up runs this run started, and whether all of them have been filed
  *
  * @openapiSchema HarnessRunFollowUp
  * @endpoint GET /v1/research/runs/{runId}
@@ -11,11 +11,11 @@ import { HarnessRunFollowUpAdmissionSchema } from "./run-follow-up-admission.js"
  * @contractRole canonical
  */
 export const HarnessRunFollowUpSchema = z.object({
-    /** PENDING until every follow-up admission is durable; REJECTED when the bounded redo is exhausted */
+    /** PENDING until every follow-up run has been filed; REJECTED when the allowed redo attempts are used up */
     admission: HarnessRunFollowUpAdmissionSchema,
-    /** More than the bounded child count exists; completion is unproven */
+    /** True when this run started more follow-up runs than this list shows, so the list cannot prove the run is complete */
     hasMore: z.boolean(),
-    /** Direct appointed run ids; read each run's detail recursively */
+    /** Ids of follow-up runs this run started directly; read each one's detail to find its own follow-ups */
     runId: z.array(z.uuid()),
 });
 //# sourceMappingURL=run-follow-up.js.map

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Queue lane for admission priority: live (search and lookup) and interactive (one client run) take interactive admission; bulk (client batch) and background (system backlog) take background admission
+ * Queue priority of a run: live (search and lookup) and interactive (one client run) share the interactive queue; bulk (client batch) and background (system backlog) share the background queue
  *
  * @openapiSchema HarnessRunLane
  * @endpoint GET /v1/research/runs

package/dist/harness/run-lane.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 const HarnessRunLaneSchemaKnownMembers = z.enum(["live", "interactive", "bulk", "background"]);
 /**
- * Queue lane for admission priority: live (search and lookup) and interactive (one client run) take interactive admission; bulk (client batch) and background (system backlog) take background admission
+ * Queue priority of a run: live (search and lookup) and interactive (one client run) share the interactive queue; bulk (client batch) and background (system backlog) share the background queue
  *
  * @openapiSchema HarnessRunLane
  * @endpoint GET /v1/research/runs

package/dist/harness/run-progress.js

@@ -12,7 +12,7 @@ import { z } from "zod/v4";
 export const HarnessRunProgressSchema = z.object({
     /** Whether the enrichment loop reports completion */
     complete: z.boolean(),
-    /** Canonical entity slug currently reported by the loop */
+    /** Slug of the entity the run is researching, as last reported */
     entitySlug: z
         .string()
         .regex(/^[a-z0-9_-]+$/)

package/dist/harness/run.js

@@ -30,9 +30,9 @@ import { ResearchAllowanceTypeSchema } from "../research/allowance-type.js";
 export const HarnessRunSchema = z.object({
     /** Retry attempt counter */
     attempt: z.int(),
-    /** Agent loop this run executes on */
+    /** Agent framework this run executes on */
     chassis: HarnessChassisSchema.nullish(),
-    /** True when the chassis router, not a caller, picked `chassis` */
+    /** True when aVenture, not the caller, chose `chassis` */
     chassisRouted: z.boolean(),
     /** Creation timestamp */
     createdAt: z.iso.datetime({ offset: true }),
@@ -48,9 +48,9 @@ export const HarnessRunSchema = z.object({
     failureClass: z.string().nullish(),
     /** Run completion timestamp */
     finishedAt: z.iso.datetime({ offset: true }).nullish(),
-    /** Successful claim acknowledgement only: true on first-ever start, false on reclaim; reads null (unknown) */
+    /** Set only in the response that starts the run: true the first time it starts, false when a worker restarts it; null in every other response */
     firstStart: z.boolean().nullish(),
-    /** Follow-up admission for the exact current terminal generation; old engine terminals remain PENDING */
+    /** Whether follow-up runs from this run's latest finish have all been filed; runs finished by older engine versions stay PENDING */
     followUpAdmission: HarnessRunFollowUpAdmissionSchema.optional(),
     /** Whether this run consumes an immutable private source document */
     hasSourceDocument: z.boolean(),
@@ -60,13 +60,13 @@ export const HarnessRunSchema = z.object({
     iteration: z.int(),
     /** Admission class (interactive or background) on client-facing responses; Prefer: run-lane-origin returns the actual queue lane. Engine lifecycle responses always return the actual lane. */
     lane: HarnessRunLaneSchema,
-    /** Latest enrich-loop status as an opaque JSON string */
+    /** Latest research-loop progress as a free-form JSON string */
     latestStatus: z.string().nullish(),
-    /** Gateway wire API every LLM call of this run uses */
+    /** Language-model API format this run's calls use */
     llmApi: HarnessLlmApiSchema.nullish(),
     /** Loop iteration cap */
     maxIteration: z.int(),
-    /** Parallel read-only scout fan-out width N */
+    /** How many read-only research helpers the run may use at once */
     maxScoutConcurrent: z.int(),
     /** Enrichment breadth selected for this run */
     mode: EnrichmentModeSchema,
@@ -78,7 +78,7 @@ export const HarnessRunSchema = z.object({
     nextAttemptAt: z.iso.datetime({ offset: true }).nullish(),
     /** Research allowance this run reserved when it was filed: COMPANY or PERSON; null for a run filed without one */
     researchAllowanceType: ResearchAllowanceTypeSchema.nullish(),
-    /** Partial or blocked direct research, derived from its recorded failure class; null for other outcomes */
+    /** How unsuccessful research ended: PARTIAL or BLOCKED, from its recorded failure class; null for other outcomes */
     researchOutcome: HarnessResearchOutcomeSchema.nullish(),
     /** Instant past which a warm resume is no longer guaranteed; the harness writes it with session_resume from the model's cache window. Warm-resumable now iff failed/stopped and this is in the future. Null when there is no resume window. */
     resumeSafeUntil: z.iso.datetime({ offset: true }).nullish(),
@@ -86,7 +86,7 @@ export const HarnessRunSchema = z.object({
     startedAt: z.iso.datetime({ offset: true }).nullish(),
     /** Current lifecycle state */
     status: HarnessRunStatusSchema,
-    /** Read-only research, cohort, and completion sub-agent model id */
+    /** Model id of the run's read-only research and check helpers */
     subagentModel: z.string().nullish(),
     /** True when the requester left `subagentModel` to the auto router, which picks it again each time the run leaves the queue; null on engine lease responses */
     subagentModelRouted: z.boolean().nullish(),

package/dist/harness/task-input-binding.js

@@ -4,7 +4,7 @@ import { EntityWriterBriefSchema } from "../entity/writer-brief.js";
 import { HarnessTaskFactSchema } from "./task-fact.js";
 import { WriterBriefSchema } from "../writer/brief.js";
 const HarnessTaskInputBindingSchemaDefinition = z.object({
-    /** Canonical entity UUID; exclusive with newsId, text, writerBrief and fact. */
+    /** Entity id (UUID); exclusive with newsId, text, writerBrief and fact. */
     entityId: z.uuid().nullish(),
     /** Section-free entity or person text brief for a WRITER_BRIEF input; exclusive with writerBrief, entityId, newsId, text and fact. The task must create entity or person text. Use this typed value only with compatible Harness readers; legacy writerBrief remains supported. */
     entityWriterBrief: EntityWriterBriefSchema.nullish(),
@@ -12,7 +12,7 @@ const HarnessTaskInputBindingSchemaDefinition = z.object({
     fact: HarnessTaskFactSchema.nullish(),
     /** Catalog input key; omit it to bind the task's only declared input of the value's type. */
     key: z.string().nullish(),
-    /** Canonical news id; exclusive with entityId, text, writerBrief and fact. */
+    /** aVenture news id; exclusive with entityId, text, writerBrief and fact. */
     newsId: z.int().nullish(),
     /** Literal requester text; exclusive with entityId, newsId, writerBrief and fact. */
     text: z.string().nullish(),

package/dist/harness/task-input-type.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * NEWS binds a public article to its canonical news id; ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states; FACT is one source-bound claim to research; WRITER_BRIEF is the typed research analysis a prose writer composes from (claim ledger, positioning frame, paragraph plan).
+ * NEWS is a public article, given by its aVenture news id; ENTITY is a target entity, identified and given by its aVenture id; TEXT is a literal value the request states; FACT is one source-bound claim to research; WRITER_BRIEF is the typed research analysis a prose writer composes from (claim ledger, positioning frame, paragraph plan).
  *
  * @openapiSchema HarnessTaskInputType
  * @endpoint POST /v1/help

package/dist/harness/task-input-type.js

@@ -8,7 +8,7 @@ const HarnessTaskInputTypeSchemaKnownMembers = z.enum([
     "WRITER_BRIEF",
 ]);
 /**
- * NEWS binds a public article to its canonical news id; ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states; FACT is one source-bound claim to research; WRITER_BRIEF is the typed research analysis a prose writer composes from (claim ledger, positioning frame, paragraph plan).
+ * NEWS is a public article, given by its aVenture news id; ENTITY is a target entity, identified and given by its aVenture id; TEXT is a literal value the request states; FACT is one source-bound claim to research; WRITER_BRIEF is the typed research analysis a prose writer composes from (claim ledger, positioning frame, paragraph plan).
  *
  * @openapiSchema HarnessTaskInputType
  * @endpoint POST /v1/help

package/dist/harness/task-plan.js

@@ -14,7 +14,7 @@ import { HarnessTaskSchema } from "./task.js";
 export const HarnessTaskPlanSchema = z.object({
     /** Stored catalog revision this plan was read from. */
     catalogRevision: z.int().optional(),
-    /** Canonical completion gate ids this task is responsible for; the ids resolve through the completion contract catalog. */
+    /** Ids of the completion checks this task must pass, as listed in the completion check catalog. */
     gateId: z.array(z.string()).optional(),
     /** Typed task inputs; required inputs must be bound before it runs. */
     input: z.array(HarnessTaskSchema),

package/dist/harness/task-write-guidance.js

@@ -20,7 +20,7 @@ export const HarnessTaskWriteGuidanceSchema = z.object({
     override: z.string(),
     /** Each problem that rejects this prose: what fails it and the fix. */
     reject: z.array(z.string()),
-    /** The read that serves this write's per-type hints; read it before writing. */
+    /** The read operation that returns per-type hints for this write; call it first. */
     typeCatalog: z.string(),
 });
 //# sourceMappingURL=task-write-guidance.js.map

package/dist/help/source-type.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Corpus partition a help citation is drawn from.
+ * Which part of the help material a citation comes from.
  *
  * @openapiSchema HelpSourceType
  * @endpoint POST /v1/help

package/dist/help/source-type.js

@@ -10,7 +10,7 @@ const HelpSourceTypeSchemaKnownMembers = z.enum([
     "TEXT_TYPE",
 ]);
 /**
- * Corpus partition a help citation is drawn from.
+ * Which part of the help material a citation comes from.
  *
  * @openapiSchema HelpSourceType
  * @endpoint POST /v1/help

package/dist/http/problem-detail.js

@@ -19,7 +19,7 @@ import { ResearchAllowanceTypeSchema } from "../research/allowance-type.js";
 export const ProblemDetailSchema = z.object({
     /** Which monthly allowance a BILLING_ALLOWANCE refusal exhausted. */
     allowanceType: ResearchAllowanceTypeSchema.nullish(),
-    /** The unmet own-site proof for an NCES campus lookup; absent for other failures. */
+    /** For a school campus lookup (NCES records), the evidence from the campus's own website that is still missing; absent for other failures. */
     campusProofRefusal: IdentificationCampusRefusalSchema.nullish(),
     circuitBreaker: z.string().nullish(),
     /** Machine-readable secondary code on ProblemDetail.code. Agents should branch on this value when the HTTP status alone does not identify the recovery path. Many codes describe server-side conditions a caller cannot fix: surface them and stop. */
@@ -286,7 +286,7 @@ export const ProblemDetailSchema = z.object({
     traceId: z.string().nullish(),
     type: z.string().optional(),
     unknownParameters: z.array(z.string()).nullish(),
-    /** On a task-completion 409, the completion gate ids whose owning reads did not pass; absent for every other problem. */
+    /** On a task-completion 409, the ids of the completion checks that failed; absent for every other problem. */
     unmetGateId: z.array(z.string()).nullish(),
     /** Requests already charged against the limitType meter this period. */
     used: z.number().int().nullish(),

package/dist/identification/candidate.js

@@ -20,9 +20,9 @@ export const IdentificationCandidateSchema = z.object({
     dataCompletionCoverage: z.int().min(0).max(100).nullish(),
     /** Whether this record's stored website agrees with a url the subject supplied; see IdentificationDomainAgreement. */
     domainAgreement: z.enum(["MATCH", "CONFLICT", "UNKNOWN"]).nullish(),
-    /** How this record was checked as the picked record stored again; absent when it was not checked. */
+    /** How this record was checked for being a duplicate of the chosen record; absent when it was not checked. */
     duplicateBasis: z.enum(["STUB", "SHARED_FACT", "JUDGED"]).nullish(),
-    /** Probability, 0 to 1, that this record is the picked record stored again; present only when duplicateBasis is JUDGED. */
+    /** Probability, 0 to 1, that this record is a duplicate of the chosen record; present only when duplicateBasis is JUDGED. */
     duplicateProbability: z.number().nullish(),
     /** The year the entity was founded, when stored; absent for people and records without one. */
     foundedYear: z.int().nullish(),

package/dist/identification/identification.js

@@ -44,9 +44,9 @@ export const IdentificationSchema = z.object({
     match: IdentificationCandidateSchema.nullish(),
     /** The subject's own website or profile page found in web search, or a supplied LinkedIn person profile verified against the subject's name and employer for a deterministic match. It may be a profile page on another site rather than the subject's own domain. Only the verified supplied profile may be attached to an existing person matched by name and employer. */
     officialUrl: z.string().nullish(),
-    /** Use the scoped match, record scoped absence, or refine an ambiguous identity with evidence. */
+    /** What to do next: use the match, record that no match exists in this scope, or add evidence to settle an ambiguous identity. */
     status: z.enum(["MATCHED", "NO_MATCH", "NEEDS_REVIEW"]),
-    /** Fresh backend URL evidence gathered when verifyUrl=true; empty otherwise. */
+    /** Results of live URL checks the server ran because verifyUrl=true; empty otherwise. */
     urlHostForm: z.array(UrlHostFormResolutionSchema),
 });
 //# sourceMappingURL=identification.js.map

package/dist/investor/portfolio-recipient.d.ts

@@ -197,7 +197,7 @@ type InvestorPortfolioRecipientDefinition = z.infer<typeof InvestorPortfolioReci
 export interface InvestorPortfolioRecipientSchemaInput extends z.input<typeof InvestorPortfolioRecipientSchemaDefinition> {
 }
 /**
- * Recipient identity with canonical recorded funding coverage.
+ * A portfolio recipient and the funding aVenture has recorded for it.
  *
  * @openapiSchema InvestorPortfolioRecipient
  * @endpoint GET /v1/entities/lookup-exact