@indexnetwork/protocol 21.0.0-rc.489.1 → 21.0.0-rc.490.1

package/dist/shared/schemas/structured-question.schema.d.ts

@@ -0,0 +1,66 @@
+import { z } from "zod";
+/**
+ * Canonical structured question shape: the title/prompt/options/multiSelect
+ * quartet every question renderer (frontend cards, MCP elicitation) consumes.
+ *
+ * It lives in `shared/` rather than inside `questions/` for the same reason as
+ * `underspecification.schema.ts`: more than one capability needs the shape.
+ * The questions capability owns question *generation* and extends this with its
+ * own provenance field; the negotiator only needs to hand over a question it
+ * authored (`AskUserPayloadSchema` in `negotiation-state.schema.ts`), and
+ * `shared/schemas` must not value-import a capability module to reach a shape.
+ *
+ * Field constraints are tuned for the renderer and are the single source of
+ * truth — `questions/question.schema.ts` re-exports rather than redeclares.
+ */
+export declare const QuestionOptionSchema: z.ZodObject<{
+    /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
+    label: z.ZodString;
+    /** Explains the consequence of choosing this option, not just its definition. */
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    description: string;
+}, {
+    label: string;
+    description: string;
+}>;
+export declare const StructuredQuestionSchema: z.ZodObject<{
+    /** ≤12 chars. Noun of the decision domain — e.g. "Stage", "Timing", "Role". */
+    title: z.ZodString;
+    /** ≤2 sentences, ≤400 chars. Ends in a question mark. */
+    prompt: z.ZodString;
+    /** 2–4 options. No explicit "Other" — clients provide that automatically. */
+    options: z.ZodArray<z.ZodObject<{
+        /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
+        label: z.ZodString;
+        /** Explains the consequence of choosing this option, not just its definition. */
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        description: string;
+    }, {
+        label: string;
+        description: string;
+    }>, "many">;
+    /** True when options are not mutually exclusive (priorities, bundles). */
+    multiSelect: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    options: {
+        label: string;
+        description: string;
+    }[];
+    title: string;
+    multiSelect: boolean;
+}, {
+    prompt: string;
+    options: {
+        label: string;
+        description: string;
+    }[];
+    title: string;
+    multiSelect: boolean;
+}>;
+export type QuestionOption = z.infer<typeof QuestionOptionSchema>;
+export type StructuredQuestion = z.infer<typeof StructuredQuestionSchema>;

package/dist/shared/schemas/structured-question.schema.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+/**
+ * Canonical structured question shape: the title/prompt/options/multiSelect
+ * quartet every question renderer (frontend cards, MCP elicitation) consumes.
+ *
+ * It lives in `shared/` rather than inside `questions/` for the same reason as
+ * `underspecification.schema.ts`: more than one capability needs the shape.
+ * The questions capability owns question *generation* and extends this with its
+ * own provenance field; the negotiator only needs to hand over a question it
+ * authored (`AskUserPayloadSchema` in `negotiation-state.schema.ts`), and
+ * `shared/schemas` must not value-import a capability module to reach a shape.
+ *
+ * Field constraints are tuned for the renderer and are the single source of
+ * truth — `questions/question.schema.ts` re-exports rather than redeclares.
+ */
+export const QuestionOptionSchema = z.object({
+    /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
+    label: z.string().min(1).max(120),
+    /** Explains the consequence of choosing this option, not just its definition. */
+    description: z.string().min(1).max(280),
+});
+export const StructuredQuestionSchema = z.object({
+    /** ≤12 chars. Noun of the decision domain — e.g. "Stage", "Timing", "Role". */
+    title: z.string().min(1).max(12),
+    /** ≤2 sentences, ≤400 chars. Ends in a question mark. */
+    prompt: z.string().min(1).max(400),
+    /** 2–4 options. No explicit "Other" — clients provide that automatically. */
+    options: z.array(QuestionOptionSchema).min(2).max(4),
+    /** True when options are not mutually exclusive (priorities, bundles). */
+    multiSelect: z.boolean(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "21.0.0-rc.489.1",
+  "version": "21.0.0-rc.490.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",