@aventurevc/api-schemas 0.8.70 → 0.8.72

package/dist/agent/help.d.ts

@@ -38,6 +38,36 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
         }>;
         probability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         taskKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taskPlan: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            catalogRevision: z.ZodInt;
+            input: z.ZodArray<z.ZodType<{
+                description: string;
+                key: string;
+                type: "ENTITY" | "TEXT";
+            }, unknown, z.core.$ZodTypeInternals<{
+                description: string;
+                key: string;
+                type: "ENTITY" | "TEXT";
+            }, unknown>>>;
+            step: z.ZodArray<z.ZodType<{
+                cliCommand: string;
+                mcpTool?: string | null | undefined;
+                step: {
+                    instruction: string;
+                    operationId: string;
+                    stepKey: string;
+                };
+            }, unknown, z.core.$ZodTypeInternals<{
+                cliCommand: string;
+                mcpTool?: string | null | undefined;
+                step: {
+                    instruction: string;
+                    operationId: string;
+                    stepKey: string;
+                };
+            }, unknown>>>;
+            taskKey: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 type AgentHelpDefinition = z.infer<typeof AgentHelpSchemaDefinition>;

package/dist/entity/filter.d.ts

@@ -5,9 +5,11 @@ import { z } from "zod/v4";
  * @openapiSchema EntityFilter
  * @endpoint POST /v1/entities/filters/refine
  * @endpoint POST /v1/entities/filters/search
+ * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @usedBySchema EntityFilterSearchSchema
  * @usedBySchema EntityNaturalSearchSchema
+ * @usedBySchema FederatedNaturalSearchSchema
  * @contractShape entity.filter
  * @contractRole canonical
  */

package/dist/entity/filter.js

@@ -14,9 +14,11 @@ import { UrlMatchModeSchema } from "../url/match-mode.js";
  * @openapiSchema EntityFilter
  * @endpoint POST /v1/entities/filters/refine
  * @endpoint POST /v1/entities/filters/search
+ * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @usedBySchema EntityFilterSearchSchema
  * @usedBySchema EntityNaturalSearchSchema
+ * @usedBySchema FederatedNaturalSearchSchema
  * @contractShape entity.filter
  * @contractRole canonical
  */

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

@@ -0,0 +1,180 @@
+import { z } from "zod/v4";
+declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
+    entityFilter: z.ZodOptional<z.ZodObject<{
+        acceleratorBrand: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        acceleratorCohort: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        acceleratorName: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        acceleratorStatus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        affinity: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        closedLast: z.ZodOptional<z.ZodBoolean>;
+        employeeCountRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown>>>>;
+        entityId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+        entityName: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        featured: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        fundraiseActivity: z.ZodOptional<z.ZodObject<{
+            amountInvestedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            amountRaisedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            investedCompanyName: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            investorActivity: z.ZodOptional<z.ZodObject<{
+                averageAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                largestAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                smallestAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                totalAmountInvestedUsdRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+                totalInvestmentRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown, z.core.$ZodTypeInternals<{
+                    max?: number | null | undefined;
+                    min?: number | null | undefined;
+                }, unknown>>>>;
+            }, z.core.$strip>>;
+            lastRoundYearRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            round: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            totalRaisedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+            valuationRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown, z.core.$ZodTypeInternals<{
+                max?: number | null | undefined;
+                min?: number | null | undefined;
+            }, unknown>>>>;
+        }, z.core.$strip>>;
+        hasFundraising: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        headquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        headquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        headquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        industry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        letter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        location: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        logoOption: z.ZodOptional<z.ZodObject<{
+            sortPriority: z.ZodOptional<z.ZodEnum<{
+                ANY_LOGO_FIRST: "ANY_LOGO_FIRST";
+                NONE: "NONE";
+                REAL_LOGO_FIRST: "REAL_LOGO_FIRST";
+            }>>;
+        }, z.core.$strip>>;
+        mainProduct: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        operatingStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            Acquired: "Acquired";
+            "Acquired Subsidiary": "Acquired Subsidiary";
+            Closed: "Closed";
+            "Closed (Acquihire)": "Closed (Acquihire)";
+            Inactive: "Inactive";
+            Operating: "Operating";
+        }>>>;
+        person: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        portfolioHeadquartersCity: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        portfolioHeadquartersCountry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        portfolioHeadquartersState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        qualityGate: z.ZodOptional<z.ZodEnum<{
+            COMPANY_LISTING_READY: "COMPANY_LISTING_READY";
+            NONE: "NONE";
+        }>>;
+        slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        stage: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        suppressNonOperating: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        suppressZeroTotalRaised: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        tag: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        textSearch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        typeCustomer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeModel: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeOwnership: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeRecord: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "Business Line": "Business Line";
+            Company: "Company";
+            Fund: "Fund";
+            Government: "Government";
+            "Investment Firm": "Investment Firm";
+            Nonprofit: "Nonprofit";
+            Organization: "Organization";
+            Product: "Product";
+            Service: "Service";
+        }>>>;
+        typeRevenue: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        typeTechnologyUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        urlDomain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        urlMatchMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            domain: "domain";
+            hostPath: "hostPath";
+        }>>>;
+        urlType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        yearFoundedRange: z.ZodOptional<z.ZodArray<z.ZodType<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown, z.core.$ZodTypeInternals<{
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        }, unknown>>>>;
+    }, z.core.$strict>>;
+    mode: z.ZodOptional<z.ZodDefault<z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    query: z.ZodString;
+}, z.core.$strip>;
+type FederatedNaturalSearchDefinition = z.infer<typeof FederatedNaturalSearchSchemaDefinition>;
+/**
+ * Plain-English search across companies, people, and news, plus optional hard constraints for the entity scope.
+ *
+ * @openapiSchema FederatedNaturalSearch
+ * @endpoint POST /v1/search
+ * @contractShape federated.natural-search
+ * @contractRole canonical
+ */
+export declare const FederatedNaturalSearchSchema: z.ZodType<FederatedNaturalSearchDefinition>;
+export type FederatedNaturalSearch = z.infer<typeof FederatedNaturalSearchSchema>;
+export {};
+//# sourceMappingURL=natural-search.d.ts.map

package/dist/federated/natural-search.js

@@ -0,0 +1,24 @@
+// 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 { EntityFilterSchema } from "../entity/filter.js";
+import { SearchModeSchema } from "../search/mode.js";
+const FederatedNaturalSearchSchemaDefinition = z.object({
+    /** Explicit entity constraints for the entity scope only, as on POST /v1/search/natural/entities: caller-supplied fields override planner values. The person and news scopes ignore it. */
+    entityFilter: EntityFilterSchema.optional(),
+    /** Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). */
+    mode: SearchModeSchema.default("auto").optional(),
+    /** Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted. */
+    model: z.string().nullish(),
+    /** Plain-English search request. */
+    query: z.string().min(1),
+});
+/**
+ * Plain-English search across companies, people, and news, plus optional hard constraints for the entity scope.
+ *
+ * @openapiSchema FederatedNaturalSearch
+ * @endpoint POST /v1/search
+ * @contractShape federated.natural-search
+ * @contractRole canonical
+ */
+export const FederatedNaturalSearchSchema = FederatedNaturalSearchSchemaDefinition;
+//# sourceMappingURL=natural-search.js.map

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

@@ -21,6 +21,15 @@ declare const FederatedSearchProvenanceSchemaDefinition: z.ZodObject<{
         modeRequested: string;
         modeUsed: string;
     }, unknown>>;
+    rejection: z.ZodArray<z.ZodType<{
+        detail: string;
+        field?: string | null | undefined;
+        scope: "entity" | "news" | "person";
+    }, unknown, z.core.$ZodTypeInternals<{
+        detail: string;
+        field?: string | null | undefined;
+        scope: "entity" | "news" | "person";
+    }, unknown>>>;
 }, z.core.$strip>;
 type FederatedSearchProvenanceDefinition = z.infer<typeof FederatedSearchProvenanceSchemaDefinition>;
 /**

package/dist/federated/search-provenance.js

@@ -1,5 +1,6 @@
 // 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 { FederatedSearchRejectionSchema } from "./search-rejection.js";
 import { SearchModeExecutionSchema } from "../search/mode-execution.js";
 const FederatedSearchProvenanceSchemaDefinition = z.object({
     /** Entity search strategy execution. */
@@ -8,6 +9,8 @@ const FederatedSearchProvenanceSchemaDefinition = z.object({
     news: SearchModeExecutionSchema,
     /** Person search strategy execution. */
     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),
 });
 /**
  * Requested and executed search strategy for every federated scope.

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

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+declare const FederatedSearchRejectionSchemaDefinition: z.ZodObject<{
+    detail: z.ZodString;
+    field: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scope: z.ZodEnum<{
+        entity: "entity";
+        news: "news";
+        person: "person";
+    }>;
+}, z.core.$strip>;
+type FederatedSearchRejectionDefinition = z.infer<typeof FederatedSearchRejectionSchemaDefinition>;
+/**
+ * One federated scope that rejected the query instead of searching.
+ *
+ * @openapiSchema FederatedSearchRejection
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @usedBySchema FederatedSearchProvenanceSchema
+ * @contractShape federated.search-rejection
+ * @contractRole canonical
+ */
+export declare const FederatedSearchRejectionSchema: z.ZodType<FederatedSearchRejectionDefinition>;
+export type FederatedSearchRejection = z.infer<typeof FederatedSearchRejectionSchema>;
+export {};
+//# sourceMappingURL=search-rejection.d.ts.map

package/dist/federated/search-rejection.js

@@ -0,0 +1,23 @@
+// 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 FederatedSearchRejectionSchemaDefinition = z.object({
+    /** Why the scope rejected the query. */
+    detail: z.string(),
+    /** Request field the scope rejected, such as search. */
+    field: z.string().nullish(),
+    /** Scope that rejected the query. */
+    scope: z.enum(["entity", "person", "news"]),
+});
+/**
+ * One federated scope that rejected the query instead of searching.
+ *
+ * @openapiSchema FederatedSearchRejection
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint POST /v1/search
+ * @usedBySchema FederatedSearchProvenanceSchema
+ * @contractShape federated.search-rejection
+ * @contractRole canonical
+ */
+export const FederatedSearchRejectionSchema = FederatedSearchRejectionSchemaDefinition;
+//# sourceMappingURL=search-rejection.js.map

package/dist/federated/search.d.ts

@@ -4,14 +4,14 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         answer?: {
             citation: {
                 entityId: string;
-                source: "entityRecord" | "newsArticle" | "researchSnippet";
+                source: string;
                 sourceId: string;
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
             paragraph: {
                 citation: {
                     entityId: string;
-                    source: "entityRecord" | "newsArticle" | "researchSnippet";
+                    source: string;
                     sourceId: string;
                 }[];
                 text: string;
@@ -622,7 +622,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             label: string;
             publishedAt?: string | null | undefined;
             score: number;
-            source: "entityRecord" | "newsArticle" | "researchSnippet";
+            source: string;
             sourceId: string;
             text: string;
             url?: string | null | undefined;
@@ -2077,14 +2077,14 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         answer?: {
             citation: {
                 entityId: string;
-                source: "entityRecord" | "newsArticle" | "researchSnippet";
+                source: string;
                 sourceId: string;
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
             paragraph: {
                 citation: {
                     entityId: string;
-                    source: "entityRecord" | "newsArticle" | "researchSnippet";
+                    source: string;
                     sourceId: string;
                 }[];
                 text: string;
@@ -2695,7 +2695,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             label: string;
             publishedAt?: string | null | undefined;
             score: number;
-            source: "entityRecord" | "newsArticle" | "researchSnippet";
+            source: string;
             sourceId: string;
             text: string;
             url?: string | null | undefined;
@@ -4188,6 +4188,33 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
         totalElements: number;
         totalPages: number;
     }, unknown>>;
+    newsEntityMention: z.ZodArray<z.ZodType<{
+        entity: {
+            createdAt: string;
+            entityId: string;
+            href?: string | null | undefined;
+            internal: boolean;
+            matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+            mention?: string | null | undefined;
+            slug?: string | null | undefined;
+            typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            updatedAt: string;
+        }[];
+        newsId: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        entity: {
+            createdAt: string;
+            entityId: string;
+            href?: string | null | undefined;
+            internal: boolean;
+            matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+            mention?: string | null | undefined;
+            slug?: string | null | undefined;
+            typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+            updatedAt: string;
+        }[];
+        newsId: number;
+    }, unknown>>>;
     person: z.ZodType<{
         interpretation: {
             confidence: "HIGH" | "LOW" | "MEDIUM";
@@ -4446,6 +4473,11 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             modeRequested: string;
             modeUsed: string;
         };
+        rejection: {
+            detail: string;
+            field?: string | null | undefined;
+            scope: "entity" | "news" | "person";
+        }[];
     }, unknown, z.core.$ZodTypeInternals<{
         entity: {
             modeRequested: string;
@@ -4459,6 +4491,11 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             modeRequested: string;
             modeUsed: string;
         };
+        rejection: {
+            detail: string;
+            field?: string | null | undefined;
+            scope: "entity" | "news" | "person";
+        }[];
     }, unknown>>;
 }, z.core.$strip>;
 type FederatedSearchDefinition = z.infer<typeof FederatedSearchSchemaDefinition>;

package/dist/federated/search.js

@@ -2,6 +2,7 @@
 import { z } from "zod/v4";
 import { FederatedSearchProvenanceSchema } from "./search-provenance.js";
 import { NaturalSearchResultSchema } from "../natural/search-result.js";
+import { NewsEntityMentionSchema } from "../news/entity-mention.js";
 import { PageResultNewsSchema } from "../pagination/schemas.js";
 import { PersonNaturalSearchResultSchema } from "../person/natural-search-result.js";
 const FederatedSearchSchemaDefinition = z.object({
@@ -9,6 +10,8 @@ const FederatedSearchSchemaDefinition = z.object({
     entity: NaturalSearchResultSchema,
     /** Canonical news page returned by the keyword list engine. */
     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),
     /** Canonical person natural-search result. */
     person: PersonNaturalSearchResultSchema,
     /** Requested and executed strategy for each search scope. */

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

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+/**
+ * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states.
+ *
+ * @openapiSchema HarnessTaskInputType
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskSchema
+ * @contractShape harness.task-input-type
+ * @contractRole canonical
+ */
+export declare const HarnessTaskInputTypeSchema: z.ZodEnum<{
+    ENTITY: "ENTITY";
+    TEXT: "TEXT";
+}>;
+export type HarnessTaskInputType = z.infer<typeof HarnessTaskInputTypeSchema>;
+//# sourceMappingURL=task-input-type.d.ts.map

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

@@ -0,0 +1,14 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+/**
+ * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states.
+ *
+ * @openapiSchema HarnessTaskInputType
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskSchema
+ * @contractShape harness.task-input-type
+ * @contractRole canonical
+ */
+export const HarnessTaskInputTypeSchema = z.enum(["ENTITY", "TEXT"]);
+//# sourceMappingURL=task-input-type.js.map

package/dist/harness/task-plan-step.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+declare const HarnessTaskPlanStepSchemaDefinition: z.ZodObject<{
+    cliCommand: z.ZodString;
+    mcpTool: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    step: z.ZodType<{
+        instruction: string;
+        operationId: string;
+        stepKey: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        instruction: string;
+        operationId: string;
+        stepKey: string;
+    }, unknown>>;
+}, z.core.$strip>;
+type HarnessTaskPlanStepDefinition = z.infer<typeof HarnessTaskPlanStepSchemaDefinition>;
+/**
+ * One task step with the CLI command and MCP tool that run its operation.
+ *
+ * @openapiSchema HarnessTaskPlanStep
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanSchema
+ * @contractShape harness.task-plan-step
+ * @contractRole canonical
+ */
+export declare const HarnessTaskPlanStepSchema: z.ZodType<HarnessTaskPlanStepDefinition>;
+export type HarnessTaskPlanStep = z.infer<typeof HarnessTaskPlanStepSchema>;
+export {};
+//# sourceMappingURL=task-plan-step.d.ts.map

package/dist/harness/task-plan-step.js

@@ -0,0 +1,23 @@
+// 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 { HarnessTaskStepSchema } from "./task-step.js";
+const HarnessTaskPlanStepSchemaDefinition = z.object({
+    /** CLI command path that runs the step's operation; the caller supplies required flags. */
+    cliCommand: z.string(),
+    /** MCP tool that runs the step's operation; null for CLI-only operations. Supply arguments matching the tool's schema. */
+    mcpTool: z.string().nullish(),
+    /** The stored step. */
+    step: HarnessTaskStepSchema,
+});
+/**
+ * One task step with the CLI command and MCP tool that run its operation.
+ *
+ * @openapiSchema HarnessTaskPlanStep
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanSchema
+ * @contractShape harness.task-plan-step
+ * @contractRole canonical
+ */
+export const HarnessTaskPlanStepSchema = HarnessTaskPlanStepSchemaDefinition;
+//# sourceMappingURL=task-plan-step.js.map

package/dist/harness/task-plan.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod/v4";
+/**
+ * One catalog task's typed inputs and ordered steps with derived CLI commands and MCP tools, read from the stated catalog revision.
+ *
+ * @openapiSchema HarnessTaskPlan
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpResolutionSchema
+ * @contractShape harness.task-plan
+ * @contractRole canonical
+ */
+export declare const HarnessTaskPlanSchema: z.ZodObject<{
+    catalogRevision: z.ZodInt;
+    input: z.ZodArray<z.ZodType<{
+        description: string;
+        key: string;
+        type: "ENTITY" | "TEXT";
+    }, unknown, z.core.$ZodTypeInternals<{
+        description: string;
+        key: string;
+        type: "ENTITY" | "TEXT";
+    }, unknown>>>;
+    step: z.ZodArray<z.ZodType<{
+        cliCommand: string;
+        mcpTool?: string | null | undefined;
+        step: {
+            instruction: string;
+            operationId: string;
+            stepKey: string;
+        };
+    }, unknown, z.core.$ZodTypeInternals<{
+        cliCommand: string;
+        mcpTool?: string | null | undefined;
+        step: {
+            instruction: string;
+            operationId: string;
+            stepKey: string;
+        };
+    }, unknown>>>;
+    taskKey: z.ZodString;
+}, z.core.$strip>;
+export type HarnessTaskPlan = z.infer<typeof HarnessTaskPlanSchema>;
+//# sourceMappingURL=task-plan.d.ts.map

package/dist/harness/task-plan.js

@@ -0,0 +1,25 @@
+// 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 { HarnessTaskPlanStepSchema } from "./task-plan-step.js";
+import { HarnessTaskSchema } from "./task.js";
+/**
+ * One catalog task's typed inputs and ordered steps with derived CLI commands and MCP tools, read from the stated catalog revision.
+ *
+ * @openapiSchema HarnessTaskPlan
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpResolutionSchema
+ * @contractShape harness.task-plan
+ * @contractRole canonical
+ */
+export const HarnessTaskPlanSchema = z.object({
+    /** Stored catalog revision this plan was read from. */
+    catalogRevision: z.int(),
+    /** Typed inputs the task needs before it runs. */
+    input: z.array(HarnessTaskSchema),
+    /** Steps in run order; an empty list means this catalog task is unplanned. */
+    step: z.array(HarnessTaskPlanStepSchema),
+    /** Agent-task catalog key. */
+    taskKey: z.string(),
+});
+//# sourceMappingURL=task-plan.js.map

package/dist/harness/task-step.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const HarnessTaskStepSchemaDefinition: z.ZodObject<{
+    instruction: z.ZodString;
+    operationId: z.ZodString;
+    stepKey: z.ZodString;
+}, z.core.$strip>;
+type HarnessTaskStepDefinition = z.infer<typeof HarnessTaskStepSchemaDefinition>;
+/**
+ * One ordered task step: its key, instruction, and the operation that runs it.
+ *
+ * @openapiSchema HarnessTaskStep
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanStepSchema
+ * @contractShape harness.task-step
+ * @contractRole canonical
+ */
+export declare const HarnessTaskStepSchema: z.ZodType<HarnessTaskStepDefinition>;
+export type HarnessTaskStep = z.infer<typeof HarnessTaskStepSchema>;
+export {};
+//# sourceMappingURL=task-step.d.ts.map