@aventurevc/api-schemas 0.8.254 → 0.8.256

package/dist/entity/analysis-section.js

@@ -0,0 +1,32 @@
+// 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 { EntityAnalysisCitationSchema } from "./analysis-citation.js";
+import { EntityAnalysisFigureSchema } from "./analysis-figure.js";
+import { EntityAnalysisParagraphSchema } from "./analysis-paragraph.js";
+import { EntityAnalysisSectionOriginSchema } from "./analysis-section-origin.js";
+const EntityAnalysisSectionSchemaDefinition = z.object({
+    /** Stored source documents and verbatim evidence quotes; verification occurs before publication. */
+    citation: z.array(EntityAnalysisCitationSchema),
+    /** At most two figures illustrating this section; each cell excerpts one of its quotes. */
+    figure: z.array(EntityAnalysisFigureSchema).optional(),
+    /** Exact typeValue from GET /v1/entities/research-snippets/types; also the section path key. */
+    key: z.string(),
+    /** Author of this edit; the server derives this from the authenticated caller. */
+    origin: EntityAnalysisSectionOriginSchema,
+    /** Paragraphs in catalog order, satisfying paragraphShape and analysisSectionLabel. */
+    paragraph: z.array(EntityAnalysisParagraphSchema),
+    /** Heading displayed above this section. */
+    title: z.string(),
+});
+/**
+ * One unverified analysis section; replace it by its snippet type key.
+ *
+ * @openapiSchema EntityAnalysisSection
+ * @endpoint GET /v1/research-runs/{runId}/draft
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
+ * @usedBySchema EntityAnalysisDraftSchema
+ * @contractShape entity.analysis-section
+ * @contractRole canonical
+ */
+export const EntityAnalysisSectionSchema = EntityAnalysisSectionSchemaDefinition;
+//# sourceMappingURL=analysis-section.js.map

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

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+declare const EntityAnalysisSourceSchemaDefinition: z.ZodObject<{
+    publicSource: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        lastFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        publishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        recordedAt: z.ZodISODateTime;
+        sourceDetail: z.ZodString;
+    }, z.core.$strip>>>;
+    sourceDocumentId: z.ZodUUID;
+}, z.core.$strip>;
+type EntityAnalysisSourceDefinition = z.infer<typeof EntityAnalysisSourceSchemaDefinition>;
+export interface EntityAnalysisSourceSchemaInput extends z.input<typeof EntityAnalysisSourceSchemaDefinition> {
+}
+/**
+ * Public page behind a source document a draft quotes; never persisted in a draft.
+ *
+ * @openapiSchema EntityAnalysisSource
+ * @endpoint GET /v1/research-runs/{runId}/draft/sources
+ * @contractShape entity.analysis-source
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisSourceSchema: z.ZodType<EntityAnalysisSourceDefinition, EntityAnalysisSourceSchemaInput>;
+export type EntityAnalysisSource = z.infer<typeof EntityAnalysisSourceSchema>;
+export {};
+//# sourceMappingURL=analysis-source.d.ts.map

package/dist/entity/analysis-source.js

@@ -0,0 +1,19 @@
+// 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 { EntityResearchPublicSourceSchema } from "./research-public-source.js";
+const EntityAnalysisSourceSchemaDefinition = z.object({
+    /** Published page URL and fetch times; absent for unavailable, private, internal, or legal sources. */
+    publicSource: EntityResearchPublicSourceSchema.nullish(),
+    /** Source document UUID a draft quote points to. */
+    sourceDocumentId: z.uuid(),
+});
+/**
+ * Public page behind a source document a draft quotes; never persisted in a draft.
+ *
+ * @openapiSchema EntityAnalysisSource
+ * @endpoint GET /v1/research-runs/{runId}/draft/sources
+ * @contractShape entity.analysis-source
+ * @contractRole canonical
+ */
+export const EntityAnalysisSourceSchema = EntityAnalysisSourceSchemaDefinition;
+//# sourceMappingURL=analysis-source.js.map

package/dist/entity/analysis-tool.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod/v4";
+/**
+ * Analysis tool
+ *
+ * @openapiSchema EntityAnalysisTool
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @usedBySchema EntityAnalysisInvocationSchema
+ * @contractShape entity.analysis-tool
+ * @contractRole canonical
+ */
+export declare const EntityAnalysisToolSchema: z.ZodEnum<{
+    LIST_SECTION: "LIST_SECTION";
+    RENDER_SECTION: "RENDER_SECTION";
+}>;
+export type EntityAnalysisTool = z.infer<typeof EntityAnalysisToolSchema>;
+//# sourceMappingURL=analysis-tool.d.ts.map

package/dist/entity/analysis-tool.js

@@ -0,0 +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";
+/**
+ * Analysis tool
+ *
+ * @openapiSchema EntityAnalysisTool
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @usedBySchema EntityAnalysisInvocationSchema
+ * @contractShape entity.analysis-tool
+ * @contractRole canonical
+ */
+export const EntityAnalysisToolSchema = z.enum(["RENDER_SECTION", "LIST_SECTION"]);
+//# sourceMappingURL=analysis-tool.js.map

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

@@ -131,6 +131,7 @@ declare const EntityFilterSearchSchemaDefinition: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        noteworthyOnly: z.ZodOptional<z.ZodBoolean>;
         operatingStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             Acquired: "Acquired";
             "Acquired Subsidiary": "Acquired Subsidiary";

package/dist/entity/filter.d.ts

@@ -152,6 +152,7 @@ export declare const EntityFilterSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    noteworthyOnly: z.ZodOptional<z.ZodBoolean>;
     operatingStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         Acquired: "Acquired";
         "Acquired Subsidiary": "Acquired Subsidiary";

package/dist/entity/filter.js

@@ -74,6 +74,8 @@ export const EntityFilterSchema = z.strictObject({
     logoOption: EntityFilterLogoOptionSchema.optional(),
     /** Main product classification values. */
     mainProduct: z.array(z.string()).optional(),
+    /** Precise notable activity in 48h. */
+    noteworthyOnly: z.boolean().optional(),
     /** Operating states to include; omit to include every state. */
     operatingStatus: z.array(EntityOperatingStatusSchema).optional(),
     /** Countries an entity is from: its headquarters country or the country of its current origin (founding) address, never a legal seat alone. What a nationality adjective (Colombian startups) means; headquartersCountry is only where it is based now. */

package/dist/entity/fundraise-rounds-param.d.ts

@@ -14,12 +14,14 @@ export declare const EntityFundraiseRoundsParamSchema: z.ZodObject<{
     size: z.ZodOptional<z.ZodInt>;
     sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     cursor: z.ZodOptional<z.ZodString>;
+    dateAnnounced: z.ZodOptional<z.ZodString>;
     dateFrom: z.ZodOptional<z.ZodISODate>;
     dateTo: z.ZodOptional<z.ZodISODate>;
     maxAmount: z.ZodOptional<z.ZodNumber>;
     minAmount: z.ZodOptional<z.ZodNumber>;
     permitMonogram: z.ZodOptional<z.ZodBoolean>;
     round: z.ZodOptional<z.ZodString>;
+    roundExact: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type EntityFundraiseRoundsParam = z.infer<typeof EntityFundraiseRoundsParamSchema>;
 //# sourceMappingURL=fundraise-rounds-param.d.ts.map

package/dist/entity/fundraise-rounds-param.js

@@ -14,6 +14,11 @@ export const ENTITY_FUNDRAISE_ROUNDS_ENDPOINT = "/v1/entities/{entityId}/fundrai
 export const EntityFundraiseRoundsParamSchema = PageParamSchema.extend({
     /** Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort. */
     cursor: z.string().optional(),
+    /** Funding rounds only; requires roundExact. ResearchDate announcement-period overlap uses the canonical participation write selector: ISO year, year-month, day or offset timestamp, preserving supplied precision. Omission imposes no date constraint. Two timestamps match only at the same instant; calendar periods overlap and timestamp/calendar comparisons use the timestamp's UTC day. */
+    dateAnnounced: z
+        .string()
+        .regex(/^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$/)
+        .optional(),
     /** Inclusive minimum announced date */
     dateFrom: z.iso.date().optional(),
     /** Inclusive maximum announced date */
@@ -26,5 +31,7 @@ export const EntityFundraiseRoundsParamSchema = PageParamSchema.extend({
     permitMonogram: z.boolean().optional(),
     /** Round label contains filter */
     round: z.string().optional(),
+    /** Funding rounds only, not outgoing investments: match the canonical participation write selector's exact stored round label, ignoring case and surrounding spaces. Cannot combine with round, dateFrom, dateTo, minAmount or maxAmount. Returns one bounded page of at most two raw ambiguity witnesses, without display deduplication: totalElements=2 means at least two matches, not an exhaustive count. Requires page=0, size>=2 and no cursor; no stable subset or export traversal is promised across requests. Omit dateAnnounced for no date constraint. */
+    roundExact: z.string().optional(),
 });
 //# sourceMappingURL=fundraise-rounds-param.js.map

package/dist/entity/fundraise-transaction.js

@@ -29,7 +29,7 @@ const EntityFundraiseTransactionSchemaDefinition = z.object({
     /** Canonical fundraise transaction UUID */
     id: z.uuid(),
     investor: z.array(EntityFundraiseInvestorJoinSchema).nullish(),
-    /** Investor-specific attribution when returned from investor-perspective investment views. amountInvested is not added to amountRaised; it is the selected investor's attributed participation amount for this round. */
+    /** Investor-specific attribution when returned from investor-perspective investment views. amountInvested is not added to amountRaised; it is the selected investor's whole investment in this round: its joins here (one per vehicle, such as a CEA and a SAFE) summed. joinId names one of those joins. */
     investorAttribution: FundraiseInvestmentAttributionSchema.nullish(),
     /** Source-reported number of investors in the round. This can exceed the identified investor joins when a source reports a total without naming every investor. */
     investorCount: z.int().nullish(),

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

@@ -14,6 +14,7 @@ export declare const EntityInvestmentsParamSchema: z.ZodObject<{
     size: z.ZodOptional<z.ZodInt>;
     sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     cursor: z.ZodOptional<z.ZodString>;
+    dateAnnounced: z.ZodOptional<z.ZodString>;
     dateFrom: z.ZodOptional<z.ZodISODate>;
     dateTo: z.ZodOptional<z.ZodISODate>;
     latestPerEntity: z.ZodOptional<z.ZodBoolean>;
@@ -21,6 +22,7 @@ export declare const EntityInvestmentsParamSchema: z.ZodObject<{
     minAmount: z.ZodOptional<z.ZodNumber>;
     permitMonogram: z.ZodOptional<z.ZodBoolean>;
     round: z.ZodOptional<z.ZodString>;
+    roundExact: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type EntityInvestmentsParam = z.infer<typeof EntityInvestmentsParamSchema>;
 //# sourceMappingURL=investments-param.d.ts.map

package/dist/entity/investments-param.js

@@ -14,6 +14,11 @@ export const ENTITY_INVESTMENTS_ENDPOINT = "/v1/entities/{entityId}/investments"
 export const EntityInvestmentsParamSchema = PageParamSchema.extend({
     /** Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort. */
     cursor: z.string().optional(),
+    /** Funding rounds only; requires roundExact. ResearchDate announcement-period overlap uses the canonical participation write selector: ISO year, year-month, day or offset timestamp, preserving supplied precision. Omission imposes no date constraint. Two timestamps match only at the same instant; calendar periods overlap and timestamp/calendar comparisons use the timestamp's UTC day. */
+    dateAnnounced: z
+        .string()
+        .regex(/^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$/)
+        .optional(),
     /** Inclusive minimum announced date */
     dateFrom: z.iso.date().optional(),
     /** Inclusive maximum announced date */
@@ -28,5 +33,7 @@ export const EntityInvestmentsParamSchema = PageParamSchema.extend({
     permitMonogram: z.boolean().optional(),
     /** Round label contains filter */
     round: z.string().optional(),
+    /** Funding rounds only, not outgoing investments: match the canonical participation write selector's exact stored round label, ignoring case and surrounding spaces. Cannot combine with round, dateFrom, dateTo, minAmount or maxAmount. Returns one bounded page of at most two raw ambiguity witnesses, without display deduplication: totalElements=2 means at least two matches, not an exhaustive count. Requires page=0, size>=2 and no cursor; no stable subset or export traversal is promised across requests. Omit dateAnnounced for no date constraint. */
+    roundExact: z.string().optional(),
 });
 //# sourceMappingURL=investments-param.js.map

package/dist/entity/list-filter.d.ts

@@ -147,6 +147,7 @@ export declare const EntityListFilterSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    noteworthyOnly: z.ZodOptional<z.ZodBoolean>;
     operatingStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         Acquired: "Acquired";
         "Acquired Subsidiary": "Acquired Subsidiary";

package/dist/entity/list-filter.js

@@ -69,6 +69,8 @@ export const EntityListFilterSchema = z.strictObject({
     logoOption: EntityFilterLogoOptionSchema.optional(),
     /** Main product classification values. */
     mainProduct: z.array(z.string()).optional(),
+    /** Precise notable activity in 48h. */
+    noteworthyOnly: z.boolean().optional(),
     /** Operating states to include; omit to include every state. */
     operatingStatus: z.array(EntityOperatingStatusSchema).optional(),
     /** Countries an entity is from: its headquarters country or the country of its current origin (founding) address, never a legal seat alone. What a nationality adjective (Colombian startups) means; headquartersCountry is only where it is based now. */

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

@@ -128,6 +128,7 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        noteworthyOnly: z.ZodOptional<z.ZodBoolean>;
         operatingStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             Acquired: "Acquired";
             "Acquired Subsidiary": "Acquired Subsidiary";

package/dist/entity/person-association-filter.d.ts

@@ -147,6 +147,7 @@ export declare const EntityPersonAssociationFilterSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        noteworthyOnly: z.ZodOptional<z.ZodBoolean>;
         operatingStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             Acquired: "Acquired";
             "Acquired Subsidiary": "Acquired Subsidiary";

package/dist/entity/research-public-source.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources and for privacy, terms, or other legal pages.
+ * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources, privacy, terms, or other legal pages, and, in public views, suppressed secondary sources such as data aggregators.
  *
  * @openapiSchema EntityResearchPublicSource
  * @endpoint GET /v1/entities
@@ -23,6 +23,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/relationships/{relationshipId}
  * @endpoint GET /v1/entities/search/jobs/{jobId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/research-runs/{runId}/draft/sources
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
@@ -35,6 +36,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/search/natural/people
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityAcquisitionSchema
+ * @usedBySchema EntityAnalysisSourceSchema
  * @usedBySchema EntityFundraiseTransactionSchema
  * @usedBySchema EntityRelationshipSchema
  * @usedBySchema EntityResearchDetailSchema

package/dist/entity/research-public-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";
 /**
- * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources and for privacy, terms, or other legal pages.
+ * Published page behind a research value, read from the provenance event that wrote the value. Absent for internal sources, privacy, terms, or other legal pages, and, in public views, suppressed secondary sources such as data aggregators.
  *
  * @openapiSchema EntityResearchPublicSource
  * @endpoint GET /v1/entities
@@ -24,6 +24,7 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/relationships/{relationshipId}
  * @endpoint GET /v1/entities/search/jobs/{jobId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/research-runs/{runId}/draft/sources
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
  * @endpoint GET /v1/search/shared/slug/{slug}
@@ -36,6 +37,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/search/natural/people
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityAcquisitionSchema
+ * @usedBySchema EntityAnalysisSourceSchema
  * @usedBySchema EntityFundraiseTransactionSchema
  * @usedBySchema EntityRelationshipSchema
  * @usedBySchema EntityResearchDetailSchema

package/dist/federated/natural-search.d.ts

@@ -134,6 +134,7 @@ declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        noteworthyOnly: z.ZodOptional<z.ZodBoolean>;
         operatingStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             Acquired: "Acquired";
             "Acquired Subsidiary": "Acquired Subsidiary";

package/dist/federated/natural-search.js

@@ -9,7 +9,7 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     answerModel: z.string().nullish(),
     /** 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. */
+    /** 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. Omitted defaults suppress non-operating entities, matching the aventure.vc search page; natural entity search is unchanged. */
     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(),
@@ -17,9 +17,9 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     model: z.string().nullish(),
     /** Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
     modelCatalogRevision: z.int().nullish(),
-    /** News scope page size; omitted uses the size query parameter, under the same page-size cap. */
+    /** News scope page size; defaults to 4, matching the aventure.vc search page, under the same page-size cap. Explicit null uses the size query parameter. */
     newsSize: z.int().nullish(),
-    /** Person scope page size; omitted uses the size query parameter, under the same page-size cap. */
+    /** Person scope page size; defaults to 10, matching the aventure.vc search page, under the same page-size cap. Explicit null uses the size query parameter. */
     personSize: z.int().nullish(),
     /** Plain-English search request. */
     query: z.string().min(1),

package/dist/federated/search.d.ts

@@ -120,6 +120,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                     sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                 } | undefined;
                 mainProduct?: string[] | undefined;
+                noteworthyOnly?: boolean | undefined;
                 operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                 originCountry?: string[] | undefined;
                 person?: string[] | undefined;
@@ -240,6 +241,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                             sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                         } | undefined;
                         mainProduct?: string[] | undefined;
+                        noteworthyOnly?: boolean | undefined;
                         operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                         originCountry?: string[] | undefined;
                         person?: string[] | undefined;
@@ -377,6 +379,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                     } | undefined;
                     mainProduct?: string[] | undefined;
+                    noteworthyOnly?: boolean | undefined;
                     operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                     originCountry?: string[] | undefined;
                     person?: string[] | undefined;
@@ -2433,6 +2436,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                     sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                 } | undefined;
                 mainProduct?: string[] | undefined;
+                noteworthyOnly?: boolean | undefined;
                 operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                 originCountry?: string[] | undefined;
                 person?: string[] | undefined;
@@ -2553,6 +2557,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                             sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                         } | undefined;
                         mainProduct?: string[] | undefined;
+                        noteworthyOnly?: boolean | undefined;
                         operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                         originCountry?: string[] | undefined;
                         person?: string[] | undefined;
@@ -2690,6 +2695,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                     } | undefined;
                     mainProduct?: string[] | undefined;
+                    noteworthyOnly?: boolean | undefined;
                     operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                     originCountry?: string[] | undefined;
                     person?: string[] | undefined;
@@ -7627,6 +7633,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                             sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                         } | undefined;
                         mainProduct?: string[] | undefined;
+                        noteworthyOnly?: boolean | undefined;
                         operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                         originCountry?: string[] | undefined;
                         person?: string[] | undefined;
@@ -7764,6 +7771,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                     } | undefined;
                     mainProduct?: string[] | undefined;
+                    noteworthyOnly?: boolean | undefined;
                     operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                     originCountry?: string[] | undefined;
                     person?: string[] | undefined;
@@ -8148,6 +8156,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                             sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                         } | undefined;
                         mainProduct?: string[] | undefined;
+                        noteworthyOnly?: boolean | undefined;
                         operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                         originCountry?: string[] | undefined;
                         person?: string[] | undefined;
@@ -8285,6 +8294,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                         sortPriority?: "ANY_LOGO_FIRST" | "NONE" | "REAL_LOGO_FIRST" | undefined;
                     } | undefined;
                     mainProduct?: string[] | undefined;
+                    noteworthyOnly?: boolean | undefined;
                     operatingStatus?: ("Acquired" | "Acquired Subsidiary" | "Closed" | "Closed (Acquihire)" | "Inactive" | "Operating")[] | undefined;
                     originCountry?: string[] | undefined;
                     person?: string[] | undefined;

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Investor-specific attribution for one fundraise participation row
+ * Investor-specific attribution: an investor's investment in one round (its joins there, one per vehicle, summed) or, in source attribution, one investor join
  *
  * @openapiSchema FundraiseInvestmentAttribution
  * @endpoint GET /v1/entities

package/dist/fundraise/investment-attribution.js

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 import { FundraiseInvestmentAttributionTypeSchema } from "./investment-attribution-type.js";
 import { RoundLabelSchema } from "../round/label.js";
 /**
- * Investor-specific attribution for one fundraise participation row
+ * Investor-specific attribution: an investor's investment in one round (its joins there, one per vehicle, summed) or, in source attribution, one investor join
  *
  * @openapiSchema FundraiseInvestmentAttribution
  * @endpoint GET /v1/entities
@@ -41,7 +41,7 @@ import { RoundLabelSchema } from "../round/label.js";
  * @contractRole canonical
  */
 export const FundraiseInvestmentAttributionSchema = z.object({
-    /** Investor-level attributed amount invested in the fundraise transaction currency. Serialized as a plain JSON number such as 220000 or 123456.78; no currency sign, currency code, comma grouping, or abbreviated amount text is valid. */
+    /** Investor-level attributed amount invested in the fundraise transaction currency: the investor's joins on the round summed for an investment, or one join's amount in source attribution. Serialized as a plain JSON number such as 220000 or 123456.78; no currency sign, currency code, comma grouping, or abbreviated amount text is valid. */
     amountInvested: z.number().nullish(),
     /** How this attribution row participates in the investor view. */
     attributionType: FundraiseInvestmentAttributionTypeSchema,
@@ -49,7 +49,7 @@ export const FundraiseInvestmentAttributionSchema = z.object({
     beneficialEntityId: z.uuid().nullish(),
     /** Fund-manager relationship id when the attribution rolls up through a managed fund. */
     fundManagerRelationshipId: z.int().nullish(),
-    /** Fundraise investor join identifier */
+    /** Fundraise investor join identifier; for a summed investment, one of the joins it sums */
     joinId: z.uuid(),
     /** Whether this investor is the lead investor for the round — the lead/anchor investor that set the round terms or made the primary commitment. */
     leadInvestor: z.boolean(),

package/dist/harness/chassis.d.ts

@@ -3,6 +3,7 @@ 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/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

package/dist/harness/chassis.js

@@ -4,6 +4,7 @@ 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/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

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

@@ -3,6 +3,7 @@ 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/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

package/dist/harness/llm-api.js

@@ -4,6 +4,7 @@ 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/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

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

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * Owning API environment
  *
  * @openapiSchema HarnessRunEnvironment
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

package/dist/harness/run-environment.js

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  * Owning API environment
  *
  * @openapiSchema HarnessRunEnvironment
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

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

@@ -15,6 +15,9 @@ export interface HarnessRunEventSchemaInput extends z.input<typeof HarnessRunEve
  *
  * @openapiSchema HarnessRunEvent
  * @endpoint GET /v1/entities/{entityId}/analysis-replay
+ * @endpoint GET /v1/research-runs/{runId}/events
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @usedBySchema CursorSliceHarnessRunEventSchema
  * @usedBySchema EntityAnalysisReplaySchema
  * @contractShape harness.run-event
  * @contractRole canonical

package/dist/harness/run-event.js

@@ -19,6 +19,9 @@ const HarnessRunEventSchemaDefinition = z.object({
  *
  * @openapiSchema HarnessRunEvent
  * @endpoint GET /v1/entities/{entityId}/analysis-replay
+ * @endpoint GET /v1/research-runs/{runId}/events
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @usedBySchema CursorSliceHarnessRunEventSchema
  * @usedBySchema EntityAnalysisReplaySchema
  * @contractShape harness.run-event
  * @contractRole canonical

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

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * Durable admission state for one terminal run generation's follow-up work
  *
  * @openapiSchema HarnessRunFollowUpAdmission
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

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

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  * Durable admission state for one terminal run generation's follow-up work
  *
  * @openapiSchema HarnessRunFollowUpAdmission
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

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

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * Queue lane for admission priority: interactive client work vs background backlog
  *
  * @openapiSchema HarnessRunLane
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

package/dist/harness/run-lane.js

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  * Queue lane for admission priority: interactive client work vs background backlog
  *
  * @openapiSchema HarnessRunLane
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

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

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * Research run lifecycle state
  *
  * @openapiSchema HarnessRunStatus
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments

package/dist/harness/run-status.js

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  * Research run lifecycle state
  *
  * @openapiSchema HarnessRunStatus
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments