@aventurevc/api-schemas 0.8.254 → 0.8.255

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/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

@@ -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

@@ -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/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

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

@@ -0,0 +1,28 @@
+import { z } from "zod/v4";
+declare const HarnessRunTurnSchemaDefinition: z.ZodObject<{
+    figure: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    invocation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        instruction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sectionKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tool: z.ZodEnum<{
+            LIST_SECTION: "LIST_SECTION";
+            RENDER_SECTION: "RENDER_SECTION";
+        }>;
+    }, z.core.$strip>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type HarnessRunTurnDefinition = z.infer<typeof HarnessRunTurnSchemaDefinition>;
+export interface HarnessRunTurnSchemaInput extends z.input<typeof HarnessRunTurnSchemaDefinition> {
+}
+/**
+ * One conversation turn; set exactly one of text or invocation
+ *
+ * @openapiSchema HarnessRunTurn
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @contractShape harness.run-turn
+ * @contractRole canonical
+ */
+export declare const HarnessRunTurnSchema: z.ZodType<HarnessRunTurnDefinition, HarnessRunTurnSchemaInput>;
+export type HarnessRunTurn = z.infer<typeof HarnessRunTurnSchema>;
+export {};
+//# sourceMappingURL=run-turn.d.ts.map

package/dist/harness/run-turn.js

@@ -0,0 +1,21 @@
+// 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 { EntityAnalysisInvocationSchema } from "../entity/analysis-invocation.js";
+const HarnessRunTurnSchemaDefinition = z.object({
+    /** True asks the analyst to also illustrate the section with figures */
+    figure: z.boolean().nullish(),
+    /** Analysis tool invocation instead of a text message */
+    invocation: EntityAnalysisInvocationSchema.nullish(),
+    /** Nonblank user message within the conversation turn character limit */
+    text: z.string().nullish(),
+});
+/**
+ * One conversation turn; set exactly one of text or invocation
+ *
+ * @openapiSchema HarnessRunTurn
+ * @endpoint POST /v1/research-runs/{runId}/turns
+ * @contractShape harness.run-turn
+ * @contractRole canonical
+ */
+export const HarnessRunTurnSchema = HarnessRunTurnSchemaDefinition;
+//# sourceMappingURL=run-turn.js.map

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

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * Research run kind: a caller-filed research request or a narrower scheduled run
  *
  * @openapiSchema HarnessRunType
+ * @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-type.js

@@ -4,6 +4,7 @@ import { z } from "zod/v4";
  * Research run kind: a caller-filed research request or a narrower scheduled run
  *
  * @openapiSchema HarnessRunType
+ * @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.d.ts

@@ -3,6 +3,7 @@ import { z } from "zod/v4";
  * One research run on a company, Product, Service, or person
  *
  * @openapiSchema HarnessRun
+ * @endpoint GET /v1/research-runs
  * @endpoint GET /v1/research-runs/{runId}
  * @endpoint POST /v1/enrichments
  * @endpoint POST /v1/entities/{entityId}/enrichments
@@ -10,6 +11,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/research-runs
  * @usedBySchema EnrichmentSchema
  * @usedBySchema HarnessRunDetailSchema
+ * @usedBySchema PageHarnessRunSchema
  * @contractShape harness.run
  * @contractRole canonical
  */