@aventurevc/api-schemas 0.8.64 → 0.8.65

package/dist/help/citation.d.ts

@@ -19,6 +19,7 @@ type HelpCitationDefinition = z.infer<typeof HelpCitationSchemaDefinition>;
  * @endpoint POST /v1/agents/help
  * @endpoint POST /v1/help
  * @usedBySchema AgentHelpSchema
+ * @usedBySchema HelpResolutionSchema
  * @contractShape help.citation
  * @contractRole canonical
  */

package/dist/help/citation.js

@@ -18,6 +18,7 @@ const HelpCitationSchemaDefinition = z.object({
  * @endpoint POST /v1/agents/help
  * @endpoint POST /v1/help
  * @usedBySchema AgentHelpSchema
+ * @usedBySchema HelpResolutionSchema
  * @contractShape help.citation
  * @contractRole canonical
  */

package/dist/help/resolution-outcome.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+/**
+ * Outcome of a resolve request.
+ *
+ * @openapiSchema HelpResolutionOutcome
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpResolutionSchema
+ * @contractShape help.resolution-outcome
+ * @contractRole canonical
+ */
+export declare const HelpResolutionOutcomeSchema: z.ZodEnum<{
+    ABSTAIN: "ABSTAIN";
+    CLARIFY: "CLARIFY";
+    OPERATION_ADVICE: "OPERATION_ADVICE";
+    TASK_PLAN: "TASK_PLAN";
+}>;
+export type HelpResolutionOutcome = z.infer<typeof HelpResolutionOutcomeSchema>;
+//# sourceMappingURL=resolution-outcome.d.ts.map

package/dist/help/resolution-outcome.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";
+/**
+ * Outcome of a resolve request.
+ *
+ * @openapiSchema HelpResolutionOutcome
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema HelpResolutionSchema
+ * @contractShape help.resolution-outcome
+ * @contractRole canonical
+ */
+export const HelpResolutionOutcomeSchema = z.enum([
+    "TASK_PLAN",
+    "OPERATION_ADVICE",
+    "CLARIFY",
+    "ABSTAIN",
+]);
+//# sourceMappingURL=resolution-outcome.js.map

package/dist/help/resolution.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod/v4";
+/**
+ * Resolution of a request to one operation: advice naming it, a clarification between candidates, or an abstention.
+ *
+ * @openapiSchema HelpResolution
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema AgentHelpSchema
+ * @contractShape help.resolution
+ * @contractRole canonical
+ */
+export declare const HelpResolutionSchema: z.ZodObject<{
+    candidate: z.ZodArray<z.ZodType<{
+        excerpt: string;
+        sourceId: string;
+        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceVersion?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        excerpt: string;
+        sourceId: string;
+        sourceType: "COMPLETION_GATE" | "OPERATION" | "PROMPT" | "RESEARCH_DETAIL_TYPE" | "SKILL";
+        sourceVersion?: string | null | undefined;
+    }, unknown>>>;
+    operationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodEnum<{
+        ABSTAIN: "ABSTAIN";
+        CLARIFY: "CLARIFY";
+        OPERATION_ADVICE: "OPERATION_ADVICE";
+        TASK_PLAN: "TASK_PLAN";
+    }>;
+    probability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type HelpResolution = z.infer<typeof HelpResolutionSchema>;
+//# sourceMappingURL=resolution.d.ts.map

package/dist/help/resolution.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 { HelpCitationSchema } from "./citation.js";
+import { HelpResolutionOutcomeSchema } from "./resolution-outcome.js";
+/**
+ * Resolution of a request to one operation: advice naming it, a clarification between candidates, or an abstention.
+ *
+ * @openapiSchema HelpResolution
+ * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
+ * @usedBySchema AgentHelpSchema
+ * @contractShape help.resolution
+ * @contractRole canonical
+ */
+export const HelpResolutionSchema = z.object({
+    /** Candidate operations best first; the options to choose between when the outcome is CLARIFY. */
+    candidate: z.array(HelpCitationSchema),
+    /** The advised operation; present only for OPERATION_ADVICE. */
+    operationId: z.string().nullish(),
+    /** Which of the mutually exclusive resolve outcomes was reached. */
+    outcome: HelpResolutionOutcomeSchema,
+    /** Probability the decision model gave the chosen option (an operation, or none). */
+    probability: z.number().nullish(),
+});
+//# sourceMappingURL=resolution.js.map