@aventurevc/api-schemas 0.8.63 → 0.8.65

package/dist/agent/help-question.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 declare const AgentHelpQuestionSchemaDefinition: z.ZodObject<{
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     question: z.ZodString;
+    resolve: z.ZodOptional<z.ZodBoolean>;
     scope: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         ALL: "ALL";
         READ: "READ";

package/dist/agent/help-question.js

@@ -6,6 +6,8 @@ const AgentHelpQuestionSchemaDefinition = z.object({
     model: z.string().nullish(),
     /** The question to answer, in natural language. */
     question: z.string().min(1),
+    /** True resolves the question to one runnable operation instead of answering it: the response carries a resolution (operation advice, clarify, or abstain) and no generated answer. Resolving calls no chat model, ignores model, and spends no help quota. */
+    resolve: z.boolean().optional(),
     /** Optional scope restricting which operations the answer may recommend; null means all. */
     scope: HelpScopeSchema.nullish(),
 });

package/dist/agent/help.d.ts

@@ -17,6 +17,27 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
         LOW: "LOW";
         MEDIUM: "MEDIUM";
     }>;
+    resolution: z.ZodOptional<z.ZodNullable<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>>>;
 }, z.core.$strip>;
 type AgentHelpDefinition = z.infer<typeof AgentHelpSchemaDefinition>;
 /**

package/dist/agent/help.js

@@ -2,6 +2,7 @@
 import { z } from "zod/v4";
 import { ConfidenceSchema } from "../confidence/confidence.js";
 import { HelpCitationSchema } from "../help/citation.js";
+import { HelpResolutionSchema } from "../help/resolution.js";
 const AgentHelpSchemaDefinition = z.object({
     /** Answer drawn only from the cited corpus; abstains when unsupported. */
     answer: z.string(),
@@ -9,6 +10,8 @@ const AgentHelpSchemaDefinition = z.object({
     citation: z.array(HelpCitationSchema),
     /** Confidence the answer is fully supported by the cited corpus. LOW signals an abstention. */
     confidence: ConfidenceSchema,
+    /** The resolved operation when the question asked to resolve; absent for a generated answer. */
+    resolution: HelpResolutionSchema.nullish(),
 });
 /**
  * Grounded natural-language help answer with citations to specific operations, skills, or completion gates. Unsupported questions abstain (LOW confidence) rather than guess.

package/dist/entity/list.d.ts

@@ -950,6 +950,7 @@ type EntityListDefinition = z.infer<typeof EntityListSchemaDefinition>;
  * @usedBySchema NaturalSearchResultSchema
  * @usedBySchema PageEntityListSchema
  * @usedBySchema PageResultEntityListSchema
+ * @usedBySchema SearchJudgmentSchema
  * @contractShape entity.list
  * @contractRole canonical
  */

package/dist/entity/list.js

@@ -35,6 +35,7 @@ const EntityListSchemaDefinition = z.object({
  * @usedBySchema NaturalSearchResultSchema
  * @usedBySchema PageEntityListSchema
  * @usedBySchema PageResultEntityListSchema
+ * @usedBySchema SearchJudgmentSchema
  * @contractShape entity.list
  * @contractRole canonical
  */