@aventurevc/api-schemas 0.8.117 → 0.8.124

package/dist/address/address.js

@@ -61,7 +61,7 @@ export const AddressSchema = z.object({
     createdAt: z.iso.datetime({ offset: true }).nullish(),
     /** Single-line formatted address */
     fullAddress: z.string().nullish(),
-    /** Address record identifier */
+    /** Id of this listed row's first association; PATCH and DELETE address one association by its association[].id, so a row holding several roles needs one call each */
     id: z.int().nullish(),
     /** Deprecated aggregate compatibility flag; true when any association is current */
     isCurrent: z.boolean().nullish(),

package/dist/address/association-role.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Meaning of an entity or person address association. Domicile is a legal or registered seat and is not evidence of operational presence; dominant is the predominant display location; origin is the founding or historical location.
+ * Meaning of an entity or person address association. Dominant is the operating headquarters; domicile is the legal or registered seat and is not evidence of operational presence; origin is the founding or historical location.
  *
  * @openapiSchema AddressAssociationRole
  * @endpoint GET /v1/entities

package/dist/address/association-role.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";
 /**
- * Meaning of an entity or person address association. Domicile is a legal or registered seat and is not evidence of operational presence; dominant is the predominant display location; origin is the founding or historical location.
+ * Meaning of an entity or person address association. Dominant is the operating headquarters; domicile is the legal or registered seat and is not evidence of operational presence; origin is the founding or historical location.
  *
  * @openapiSchema AddressAssociationRole
  * @endpoint GET /v1/entities

package/dist/agent/help.d.ts

@@ -4,12 +4,12 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
     citation: z.ZodArray<z.ZodType<{
         excerpt: string;
         sourceId: string;
-        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceType: string;
         sourceVersion?: string | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
         excerpt: string;
         sourceId: string;
-        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceType: string;
         sourceVersion?: string | null | undefined;
     }, unknown>>>;
     confidence: z.ZodEnum<{
@@ -21,12 +21,12 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
         candidate: z.ZodArray<z.ZodType<{
             excerpt: string;
             sourceId: string;
-            sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+            sourceType: string;
             sourceVersion?: string | null | undefined;
         }, unknown, z.core.$ZodTypeInternals<{
             excerpt: string;
             sourceId: string;
-            sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+            sourceType: string;
             sourceVersion?: string | null | undefined;
         }, unknown>>>;
         operationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -58,6 +58,14 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
                     operationId: string;
                     stepKey: string;
                 };
+                writeGuidance?: {
+                    body: string;
+                    expectation: string;
+                    method: string[];
+                    override: string;
+                    reject: string[];
+                    typeCatalog: string;
+                } | null | undefined;
             }, unknown, z.core.$ZodTypeInternals<{
                 cliCommand: string;
                 mcpTool?: string | null | undefined;
@@ -66,6 +74,14 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
                     operationId: string;
                     stepKey: string;
                 };
+                writeGuidance?: {
+                    body: string;
+                    expectation: string;
+                    method: string[];
+                    override: string;
+                    reject: string[];
+                    typeCatalog: string;
+                } | null | undefined;
             }, unknown>>>;
             taskKey: z.ZodString;
         }, z.core.$strip>>>;

package/dist/datasource/data-source-type.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+/**
+ * Full read/storage source type for field-level provenance rows. Write query parameters use DatasourceWritableDataSourceType.
+ *
+ * @openapiSchema DatasourceDataSourceType
+ * @endpoint GET /v1/entities
+ * @contractShape datasource.data-source-type
+ * @contractRole canonical
+ */
+export declare const DatasourceDataSourceTypeSchema: z.ZodEnum<{
+    api: "api";
+    aventureStaff: "aventureStaff";
+    blogArticle: "blogArticle";
+    firstPartyWebsite: "firstPartyWebsite";
+    import: "import";
+    llm: "llm";
+    manual: "manual";
+    newsArticle: "newsArticle";
+    relatedPartyWebsite: "relatedPartyWebsite";
+    requestChangeForm: "requestChangeForm";
+    thirdPartyWebsite: "thirdPartyWebsite";
+}>;
+export type DatasourceDataSourceType = z.infer<typeof DatasourceDataSourceTypeSchema>;
+//# sourceMappingURL=data-source-type.d.ts.map

package/dist/datasource/data-source-type.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";
+/**
+ * Full read/storage source type for field-level provenance rows. Write query parameters use DatasourceWritableDataSourceType.
+ *
+ * @openapiSchema DatasourceDataSourceType
+ * @endpoint GET /v1/entities
+ * @contractShape datasource.data-source-type
+ * @contractRole canonical
+ */
+export const DatasourceDataSourceTypeSchema = z.enum([
+    "requestChangeForm",
+    "newsArticle",
+    "blogArticle",
+    "firstPartyWebsite",
+    "relatedPartyWebsite",
+    "thirdPartyWebsite",
+    "llm",
+    "aventureStaff",
+    "api",
+    "manual",
+    "import",
+]);
+//# sourceMappingURL=data-source-type.js.map

package/dist/entity/enrichment.js

@@ -10,7 +10,7 @@ const EntityEnrichmentSchemaDefinition = z.object({
     /** Entity classification join projection for this read surface. Single-detail and full-detail batch reads include full history; list, default batch, and similar-entity reads may filter to current joins. Use GET /v1/entities/{entityId}/classifications?includeInactive=true for authoritative join history. */
     classification: EntityClassificationSchema,
     fundingDetail: EntityFundingDetailSchema.nullish(),
-    /** Address id of the current headquarters: the current dominant (operating) address, else the current domicile (legal seat); absent when neither is on record. Read this instead of the deprecated isHq flag, which marks the legal seat. */
+    /** Address id of the current headquarters: the current dominant (operating) address; absent when none is on record, even when a domicile (legal seat) exists. Read this instead of the deprecated isHq flag, which marks the legal seat. */
     headquartersAddressId: z.int().nullish(),
     text: EntityTextBundleSchema,
     /** URL link filter values */

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

@@ -0,0 +1,39 @@
+import { z } from "zod/v4";
+/**
+ * Entity filter sortable
+ *
+ * @openapiSchema EntityFilterSortable
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SortOrderEntityFilterSortableSchema
+ * @contractShape entity.filter-sortable
+ * @contractRole canonical
+ */
+export declare const EntityFilterSortableSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    ACCELERATOR_BRAND: "ACCELERATOR_BRAND";
+    ACCELERATOR_COHORT: "ACCELERATOR_COHORT";
+    AMOUNT_INVESTED: "AMOUNT_INVESTED";
+    CREATED_AT: "CREATED_AT";
+    DATA_COMPLETION_COVERAGE: "DATA_COMPLETION_COVERAGE";
+    EMPLOYEE_COUNT: "EMPLOYEE_COUNT";
+    HEADQUARTERS_COUNTRY: "HEADQUARTERS_COUNTRY";
+    ID: "ID";
+    LATEST_VALUATION: "LATEST_VALUATION";
+    MOST_RECENT_AMOUNT: "MOST_RECENT_AMOUNT";
+    MOST_RECENT_DATE: "MOST_RECENT_DATE";
+    NAME_BRAND: "NAME_BRAND";
+    NEXT_DUE_AT: "NEXT_DUE_AT";
+    RECENT_INVESTMENT_AT: "RECENT_INVESTMENT_AT";
+    STAGE: "STAGE";
+    STATUS_OPERATING: "STATUS_OPERATING";
+    TOTAL_RAISED: "TOTAL_RAISED";
+    UPDATED_AT: "UPDATED_AT";
+    YEAR_FOUNDED: "YEAR_FOUNDED";
+}>, z.ZodString]>;
+export type EntityFilterSortable = z.infer<typeof EntityFilterSortableSchema>;
+//# sourceMappingURL=filter-sortable.d.ts.map

package/dist/entity/filter-sortable.js

@@ -0,0 +1,42 @@
+// 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 filter sortable
+ *
+ * @openapiSchema EntityFilterSortable
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/natural/entities
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SortOrderEntityFilterSortableSchema
+ * @contractShape entity.filter-sortable
+ * @contractRole canonical
+ */
+export const EntityFilterSortableSchema = z.union([
+    z.enum([
+        "ID",
+        "NAME_BRAND",
+        "YEAR_FOUNDED",
+        "STATUS_OPERATING",
+        "UPDATED_AT",
+        "CREATED_AT",
+        "NEXT_DUE_AT",
+        "DATA_COMPLETION_COVERAGE",
+        "TOTAL_RAISED",
+        "AMOUNT_INVESTED",
+        "RECENT_INVESTMENT_AT",
+        "STAGE",
+        "MOST_RECENT_AMOUNT",
+        "LATEST_VALUATION",
+        "MOST_RECENT_DATE",
+        "ACCELERATOR_BRAND",
+        "ACCELERATOR_COHORT",
+        "HEADQUARTERS_COUNTRY",
+        "EMPLOYEE_COUNT",
+    ]),
+    z.string(),
+]);
+//# sourceMappingURL=filter-sortable.js.map

package/dist/entity/filter.js

@@ -83,7 +83,7 @@ export const EntityFilterSchema = z.strictObject({
     portfolioHeadquartersCountry: z.array(z.string()).optional(),
     /** Portfolio-company headquarters state or region values. */
     portfolioHeadquartersState: z.array(z.string()).optional(),
-    /** Named server-owned list quality gate. */
+    /** Server-owned list quality gate. */
     qualityGate: EntityListQualityGateSchema.optional(),
     /** Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean. */
     rankByProminence: z.boolean().nullish(),
@@ -100,7 +100,7 @@ export const EntityFilterSchema = z.strictObject({
     suppressLateStage: z.boolean().nullish(),
     /** Suppress entities with terminal operating status. */
     suppressNonOperating: z.boolean().nullish(),
-    /** Suppress entities whose USD-converted total raised is zero or unknown. */
+    /** Suppress entities with zero or unknown USD total raised. */
     suppressZeroTotalRaised: z.boolean().nullish(),
     /** General classification tag values. */
     tag: z.array(z.string()).optional(),

package/dist/entity/list-filter.js

@@ -61,7 +61,7 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     portfolioHeadquartersCountry: z.array(z.string()).optional(),
     /** Portfolio-company headquarters state or region values. */
     portfolioHeadquartersState: z.array(z.string()).optional(),
-    /** Named server-owned list quality gate. */
+    /** Server-owned list quality gate. */
     qualityGate: EntityListQualityGateSchema.optional(),
     /** Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean. */
     rankByProminence: z.boolean().nullish(),
@@ -80,7 +80,7 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     suppressLateStage: z.boolean().nullish(),
     /** Suppress entities with terminal operating status. */
     suppressNonOperating: z.boolean().nullish(),
-    /** Suppress entities whose USD-converted total raised is zero or unknown. */
+    /** Suppress entities with zero or unknown USD total raised. */
     suppressZeroTotalRaised: z.boolean().nullish(),
     /** General classification tag values. */
     tag: z.array(z.string()).optional(),

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

@@ -174,12 +174,14 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
         }, unknown>>>>;
     }, z.core.$strict>>;
     search: z.ZodType<{
+        answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;
         query: string;
         reasoningEffort?: string | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
+        answerModel?: string | null | undefined;
         cacheMode?: "bypass" | "refresh" | "use" | undefined;
         mode?: string | undefined;
         model?: string | null | undefined;

package/dist/entity/person-association.js

@@ -44,7 +44,7 @@ export const EntityPersonAssociationSchema = z.object({
         .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-9]{2}:[0-5][0-9]))?)?)?$/)
         .nullish(),
-    /** Entity addresses carried on the association projection */
+    /** Entity addresses carried on the association projection. Person detail carries at most one: the entity's current headquarters, else its most recently updated current address; GET /v1/entities/{entityId}/addresses lists them all */
     entityAddress: z.array(AddressSchema),
     /** Associated entity id */
     entityId: z.uuid(),

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

@@ -1,5 +1,16 @@
 import { z } from "zod/v4";
-declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
+/**
+ * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
+ *
+ * @openapiSchema FederatedNaturalSearch
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SharedSearchMutationSchema
+ * @contractShape federated.natural-search
+ * @contractRole canonical
+ */
+export declare const FederatedNaturalSearchSchema: z.ZodObject<{
+    answerModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cacheMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
         bypass: "bypass";
         refresh: "refresh";
@@ -199,16 +210,5 @@ declare const FederatedNaturalSearchSchemaDefinition: z.ZodObject<{
         xhigh: "xhigh";
     }>, z.ZodString]>>>;
 }, z.core.$strip>;
-type FederatedNaturalSearchDefinition = z.infer<typeof FederatedNaturalSearchSchemaDefinition>;
-/**
- * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
- *
- * @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

@@ -4,8 +4,20 @@ import { EntityFilterSchema } from "../entity/filter.js";
 import { ReasoningEffortSchema } from "../reasoning/effort.js";
 import { SearchCacheModeSchema } from "../search/cache-mode.js";
 import { SearchModeSchema } from "../search/mode.js";
-const FederatedNaturalSearchSchemaDefinition = z.object({
-    /** Search-stage cache policy. use reuses cached search work; bypass computes fresh without retaining outputs; refresh computes fresh and replaces normal entries. Record and immutable query-vector caches retain their own policy. */
+/**
+ * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
+ *
+ * @openapiSchema FederatedNaturalSearch
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema SharedSearchMutationSchema
+ * @contractShape federated.natural-search
+ * @contractRole canonical
+ */
+export const FederatedNaturalSearchSchema = z.object({
+    /** Optional chat model for the synthesis answer; null uses the catalog's search answer model. The same allowlist as `model` applies. The answer writes the page heading, title, and description, so this compares answer models without changing the catalog. */
+    answerModel: z.string().nullish(),
+    /** Search-stage cache policy. use reuses cached search work; bypass computes fresh without retaining outputs; refresh computes fresh and replaces normal entries. Record and immutable query-vector caches retain their own policy. Callers without private-data access always run use. */
     cacheMode: SearchCacheModeSchema.default("use").optional(),
     /** Explicit entity constraints for the entity scope only, as on POST /v1/search/natural/entities: caller-supplied fields override planner values. The person and news scopes ignore it. */
     entityFilter: EntityFilterSchema.optional(),
@@ -22,13 +34,4 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Callers without private-data access are capped at `medium`. Null keeps the configured per-call and per-model defaults. */
     reasoningEffort: ReasoningEffortSchema.nullish(),
 });
-/**
- * Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.
- *
- * @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.d.ts

@@ -9,6 +9,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
             description?: string | null | undefined;
+            heading?: string | null | undefined;
             paragraph: {
                 citation: {
                     entityId: string;
@@ -146,7 +147,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             sort: {
                 order: {
                     descending: boolean;
-                    field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+                    field: string;
                     sortKey?: string | null | undefined;
                 }[];
                 relevance?: "keyword" | "semantic" | null | undefined;
@@ -1795,6 +1796,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             }[];
             confidence: "HIGH" | "LOW" | "MEDIUM";
             description?: string | null | undefined;
+            heading?: string | null | undefined;
             paragraph: {
                 citation: {
                     entityId: string;
@@ -1932,7 +1934,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
             sort: {
                 order: {
                     descending: boolean;
-                    field: "ACCELERATOR_BRAND" | "ACCELERATOR_COHORT" | "AMOUNT_INVESTED" | "CREATED_AT" | "EMPLOYEE_COUNT" | "HEADQUARTERS_COUNTRY" | "ID" | "LATEST_VALUATION" | "MOST_RECENT_AMOUNT" | "MOST_RECENT_DATE" | "NAME_BRAND" | "RECENT_INVESTMENT_AT" | "STAGE" | "STATUS_OPERATING" | "TOTAL_RAISED" | "UPDATED_AT" | "YEAR_FOUNDED";
+                    field: string;
                     sortKey?: string | null | undefined;
                 }[];
                 relevance?: "keyword" | "semantic" | null | undefined;

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

@@ -11,6 +11,14 @@ declare const HarnessTaskPlanStepSchemaDefinition: z.ZodObject<{
         operationId: string;
         stepKey: string;
     }, unknown>>;
+    writeGuidance: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        body: z.ZodString;
+        expectation: z.ZodString;
+        method: z.ZodArray<z.ZodString>;
+        override: z.ZodString;
+        reject: z.ZodArray<z.ZodString>;
+        typeCatalog: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type HarnessTaskPlanStepDefinition = z.infer<typeof HarnessTaskPlanStepSchemaDefinition>;
 /**

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

@@ -1,6 +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";
 import { HarnessTaskStepSchema } from "./task-step.js";
+import { HarnessTaskWriteGuidanceSchema } from "./task-write-guidance.js";
 const HarnessTaskPlanStepSchemaDefinition = z.object({
     /** CLI command path that runs the step's operation; the caller supplies required flags. */
     cliCommand: z.string(),
@@ -8,6 +9,8 @@ const HarnessTaskPlanStepSchemaDefinition = z.object({
     mcpTool: z.string().nullish(),
     /** The stored step. */
     step: HarnessTaskStepSchema,
+    /** What the server expects of the prose this step writes, derived from the operation's judged prose type when the plan is read; null when the step writes no judged prose. */
+    writeGuidance: HarnessTaskWriteGuidanceSchema.nullish(),
 });
 /**
  * One task step with the CLI command and MCP tool that run its operation.

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

@@ -29,6 +29,14 @@ export declare const HarnessTaskPlanSchema: z.ZodObject<{
             operationId: string;
             stepKey: string;
         };
+        writeGuidance?: {
+            body: string;
+            expectation: string;
+            method: string[];
+            override: string;
+            reject: string[];
+            typeCatalog: string;
+        } | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
         cliCommand: string;
         mcpTool?: string | null | undefined;
@@ -37,6 +45,14 @@ export declare const HarnessTaskPlanSchema: z.ZodObject<{
             operationId: string;
             stepKey: string;
         };
+        writeGuidance?: {
+            body: string;
+            expectation: string;
+            method: string[];
+            override: string;
+            reject: string[];
+            typeCatalog: string;
+        } | null | undefined;
     }, unknown>>>;
     taskKey: z.ZodString;
 }, z.core.$strip>;

package/dist/harness/task-write-guidance.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+/**
+ * The expectation, body, type hints, rejections, override, and method for one judged prose write.
+ *
+ * @openapiSchema HarnessTaskWriteGuidance
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanStepSchema
+ * @contractShape harness.task-write-guidance
+ * @contractRole canonical
+ */
+export declare const HarnessTaskWriteGuidanceSchema: z.ZodObject<{
+    body: z.ZodString;
+    expectation: z.ZodString;
+    method: z.ZodArray<z.ZodString>;
+    override: z.ZodString;
+    reject: z.ZodArray<z.ZodString>;
+    typeCatalog: z.ZodString;
+}, z.core.$strip>;
+export type HarnessTaskWriteGuidance = z.infer<typeof HarnessTaskWriteGuidanceSchema>;
+//# sourceMappingURL=task-write-guidance.d.ts.map

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

@@ -0,0 +1,27 @@
+// 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";
+/**
+ * The expectation, body, type hints, rejections, override, and method for one judged prose write.
+ *
+ * @openapiSchema HarnessTaskWriteGuidance
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HarnessTaskPlanStepSchema
+ * @contractShape harness.task-write-guidance
+ * @contractRole canonical
+ */
+export const HarnessTaskWriteGuidanceSchema = z.object({
+    /** The request body keys, the key that carries the prose, and a minimal JSON example. */
+    body: z.string(),
+    /** The one sentence the prose aims for. */
+    expectation: z.string(),
+    /** Help sections that teach this prose, each with the command that retrieves it. */
+    method: z.array(z.string()),
+    /** The override field, the problems it may waive, and its terms. */
+    override: z.string(),
+    /** Each problem that rejects this prose: what fails it and the fix. */
+    reject: z.array(z.string()),
+    /** The read that serves this write's per-type hints; read it before writing. */
+    typeCatalog: z.string(),
+});
+//# sourceMappingURL=task-write-guidance.js.map

package/dist/help/citation.d.ts

@@ -2,13 +2,15 @@ import { z } from "zod/v4";
 declare const HelpCitationSchemaDefinition: z.ZodObject<{
     excerpt: z.ZodString;
     sourceId: z.ZodString;
-    sourceType: z.ZodEnum<{
+    sourceType: z.ZodUnion<readonly [z.ZodEnum<{
         COMPLETION_GATE: "COMPLETION_GATE";
         OPERATION: "OPERATION";
         PROMPT: "PROMPT";
         RESEARCH_DETAIL_TYPE: "RESEARCH_DETAIL_TYPE";
+        RESEARCH_SNIPPET_TYPE: "RESEARCH_SNIPPET_TYPE";
         SKILL: "SKILL";
-    }>;
+        TEXT_TYPE: "TEXT_TYPE";
+    }>, z.ZodString]>;
     sourceVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type HelpCitationDefinition = z.infer<typeof HelpCitationSchemaDefinition>;

package/dist/help/resolution.d.ts

@@ -13,12 +13,12 @@ export declare const HelpResolutionSchema: z.ZodObject<{
     candidate: z.ZodArray<z.ZodType<{
         excerpt: string;
         sourceId: string;
-        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceType: string;
         sourceVersion?: string | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
         excerpt: string;
         sourceId: string;
-        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceType: string;
         sourceVersion?: string | null | undefined;
     }, unknown>>>;
     operationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -50,6 +50,14 @@ export declare const HelpResolutionSchema: z.ZodObject<{
                 operationId: string;
                 stepKey: string;
             };
+            writeGuidance?: {
+                body: string;
+                expectation: string;
+                method: string[];
+                override: string;
+                reject: string[];
+                typeCatalog: string;
+            } | null | undefined;
         }, unknown, z.core.$ZodTypeInternals<{
             cliCommand: string;
             mcpTool?: string | null | undefined;
@@ -58,6 +66,14 @@ export declare const HelpResolutionSchema: z.ZodObject<{
                 operationId: string;
                 stepKey: string;
             };
+            writeGuidance?: {
+                body: string;
+                expectation: string;
+                method: string[];
+                override: string;
+                reject: string[];
+                typeCatalog: string;
+            } | null | undefined;
         }, unknown>>>;
         taskKey: z.ZodString;
     }, z.core.$strip>>>;

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

@@ -9,12 +9,14 @@ import { z } from "zod/v4";
  * @contractShape help.source-type
  * @contractRole canonical
  */
-export declare const HelpSourceTypeSchema: z.ZodEnum<{
+export declare const HelpSourceTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     COMPLETION_GATE: "COMPLETION_GATE";
     OPERATION: "OPERATION";
     PROMPT: "PROMPT";
     RESEARCH_DETAIL_TYPE: "RESEARCH_DETAIL_TYPE";
+    RESEARCH_SNIPPET_TYPE: "RESEARCH_SNIPPET_TYPE";
     SKILL: "SKILL";
-}>;
+    TEXT_TYPE: "TEXT_TYPE";
+}>, z.ZodString]>;
 export type HelpSourceType = z.infer<typeof HelpSourceTypeSchema>;
 //# sourceMappingURL=source-type.d.ts.map

package/dist/help/source-type.js

@@ -10,11 +10,16 @@ import { z } from "zod/v4";
  * @contractShape help.source-type
  * @contractRole canonical
  */
-export const HelpSourceTypeSchema = z.enum([
-    "OPERATION",
-    "SKILL",
-    "PROMPT",
-    "COMPLETION_GATE",
-    "RESEARCH_DETAIL_TYPE",
+export const HelpSourceTypeSchema = z.union([
+    z.enum([
+        "OPERATION",
+        "SKILL",
+        "PROMPT",
+        "COMPLETION_GATE",
+        "RESEARCH_DETAIL_TYPE",
+        "RESEARCH_SNIPPET_TYPE",
+        "TEXT_TYPE",
+    ]),
+    z.string(),
 ]);
 //# sourceMappingURL=source-type.js.map