@indexnetwork/protocol 0.31.0-rc.119.1 → 0.33.0-rc.121.1

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

@@ -0,0 +1,182 @@
+/**
+ * Question — public structured shape consumed by frontend renderers and MCP
+ * elicitation dispatch. Mirrors the brainstorming AskUserQuestion skill so a
+ * Question can be rendered identically across surfaces.
+ *
+ * `QuestionWithStrategy` extends the public shape with an internal `strategy`
+ * tag used by the generator's guardrails (dedup/diversity) and recorded in
+ * `debugMeta`. The tag is stripped before the public payload leaves the
+ * generator — users never see it.
+ */
+import { z } from "zod";
+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, {
+    description: string;
+    label: string;
+}, {
+    description: string;
+    label: string;
+}>;
+export declare const QuestionSchema: 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, {
+        description: string;
+        label: string;
+    }, {
+        description: string;
+        label: string;
+    }>, "many">;
+    /** True when options are not mutually exclusive (priorities, bundles). */
+    multiSelect: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    options: {
+        description: string;
+        label: string;
+    }[];
+    title: string;
+    multiSelect: boolean;
+}, {
+    prompt: string;
+    options: {
+        description: string;
+        label: string;
+    }[];
+    title: string;
+    multiSelect: boolean;
+}>;
+export declare const QuestionStrategySchema: z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>;
+export declare const QuestionWithStrategySchema: 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, {
+        description: string;
+        label: string;
+    }, {
+        description: string;
+        label: string;
+    }>, "many">;
+    /** True when options are not mutually exclusive (priorities, bundles). */
+    multiSelect: z.ZodBoolean;
+} & {
+    strategy: z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    options: {
+        description: string;
+        label: string;
+    }[];
+    title: string;
+    multiSelect: boolean;
+    strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
+}, {
+    prompt: string;
+    options: {
+        description: string;
+        label: string;
+    }[];
+    title: string;
+    multiSelect: boolean;
+    strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
+}>;
+export declare const QuestionGeneratorResponseSchema: z.ZodObject<{
+    questions: z.ZodArray<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, {
+            description: string;
+            label: string;
+        }, {
+            description: string;
+            label: string;
+        }>, "many">;
+        /** True when options are not mutually exclusive (priorities, bundles). */
+        multiSelect: z.ZodBoolean;
+    } & {
+        strategy: z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        options: {
+            description: string;
+            label: string;
+        }[];
+        title: string;
+        multiSelect: boolean;
+        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
+    }, {
+        prompt: string;
+        options: {
+            description: string;
+            label: string;
+        }[];
+        title: string;
+        multiSelect: boolean;
+        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    questions: {
+        prompt: string;
+        options: {
+            description: string;
+            label: string;
+        }[];
+        title: string;
+        multiSelect: boolean;
+        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
+    }[];
+}, {
+    questions: {
+        prompt: string;
+        options: {
+            description: string;
+            label: string;
+        }[];
+        title: string;
+        multiSelect: boolean;
+        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
+    }[];
+}>;
+export type QuestionOption = z.infer<typeof QuestionOptionSchema>;
+export type Question = z.infer<typeof QuestionSchema>;
+export type QuestionStrategy = z.infer<typeof QuestionStrategySchema>;
+export type QuestionWithStrategy = z.infer<typeof QuestionWithStrategySchema>;
+export type QuestionGeneratorResponse = z.infer<typeof QuestionGeneratorResponseSchema>;
+/**
+ * Internal generator output: public questions plus a parallel strategies
+ * array for debug-only consumption. The generator emits this; callers
+ * forward `questions` to renderers and `strategies` to `debugMeta` only.
+ */
+export interface QuestionGenerationResult {
+    questions: Question[];
+    strategies: QuestionStrategy[];
+}
+//# sourceMappingURL=question.schema.d.ts.map

package/dist/shared/schemas/question.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.schema.d.ts","sourceRoot":"","sources":["../../../src/shared/schemas/question.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;IAC/B,+EAA+E;;IAE/E,iFAAiF;;;;;;;;EAEjF,CAAC;AAEH,eAAO,MAAM,cAAc;IACzB,+EAA+E;;IAE/E,yDAAyD;;IAEzD,6EAA6E;;QAX7E,+EAA+E;;QAE/E,iFAAiF;;;;;;;;;IAWjF,0EAA0E;;;;;;;;;;;;;;;;;;EAE1E,CAAC;AAEH,eAAO,MAAM,sBAAsB,oIAMjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;IAlBrC,+EAA+E;;IAE/E,yDAAyD;;IAEzD,6EAA6E;;QAX7E,+EAA+E;;QAE/E,iFAAiF;;;;;;;;;IAWjF,0EAA0E;;;;;;;;;;;;;;;;;;;;;;EAc1E,CAAC;AAEH,eAAO,MAAM,+BAA+B;;QAtB1C,+EAA+E;;QAE/E,yDAAyD;;QAEzD,6EAA6E;;YAX7E,+EAA+E;;YAE/E,iFAAiF;;;;;;;;;QAWjF,0EAA0E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1E,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC"}

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

@@ -0,0 +1,41 @@
+/**
+ * Question — public structured shape consumed by frontend renderers and MCP
+ * elicitation dispatch. Mirrors the brainstorming AskUserQuestion skill so a
+ * Question can be rendered identically across surfaces.
+ *
+ * `QuestionWithStrategy` extends the public shape with an internal `strategy`
+ * tag used by the generator's guardrails (dedup/diversity) and recorded in
+ * `debugMeta`. The tag is stripped before the public payload leaves the
+ * generator — users never see it.
+ */
+import { z } from "zod";
+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 QuestionSchema = 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(),
+});
+export const QuestionStrategySchema = z.enum([
+    "refine_intent",
+    "surface_missing_detail",
+    "open_adjacent_thread",
+    "reflective_summary",
+    "surface_emergent_knowledge",
+]);
+export const QuestionWithStrategySchema = QuestionSchema.extend({
+    strategy: QuestionStrategySchema,
+});
+export const QuestionGeneratorResponseSchema = z.object({
+    questions: z.array(QuestionWithStrategySchema).max(3),
+});
+//# sourceMappingURL=question.schema.js.map

package/dist/shared/schemas/question.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.schema.js","sourceRoot":"","sources":["../../../src/shared/schemas/question.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,+EAA+E;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC,iFAAiF;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,+EAA+E;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAChC,yDAAyD;IACzD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,6EAA6E;IAC7E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,0EAA0E;IAC1E,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,eAAe;IACf,wBAAwB;IACxB,sBAAsB;IACtB,oBAAoB;IACpB,4BAA4B;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC,MAAM,CAAC;IAC9D,QAAQ,EAAE,sBAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACtD,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "0.31.0-rc.119.1",
+  "version": "0.33.0-rc.121.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",