npm - @indexnetwork/protocol - Versions diffs - 4.11.0-rc.351.1 → 4.13.0-rc.353.1 - Mend

@indexnetwork/protocol 4.11.0-rc.351.1 → 4.13.0-rc.353.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

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

@@ -219,6 +219,8 @@ export interface QuestionGenerationResult {
     strategies: QuestionStrategy[];
     underspecificationTypes: Array<UnderspecificationType | null>;
 }
+/** Internal reason a question was generated, orthogonal to mode and QUD metadata. */
+export declare const QuestionPurposeSchema: z.ZodEnum<["uptake"]>;
 export declare const QuestionModeSchema: z.ZodEnum<["discovery", "intent", "enrichment", "negotiation", "negotiation_inflight", "chat", "pool_discovery"]>;
 /** One server-side candidate→side assignment (never serialized to clients). */
 export declare const QuestionPoolAssignmentSchema: z.ZodObject<{
@@ -245,6 +247,10 @@ export declare const QuestionPoolDiscriminatorSchema: z.ZodObject<{
     sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
     voi: z.ZodNumber;
     evidenceRate: z.ZodNumber;
+    /** Discriminator embedding retained for durable semantic novelty checks. */
+    embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    /** Model that generated `embedding`; mismatches must fall back to text. */
+    embeddingModel: z.ZodOptional<z.ZodString>;
     /** Verified assignments only — the P3 re-rank input. */
     assignments: z.ZodArray<z.ZodObject<{
         opportunityId: z.ZodString;
@@ -267,6 +273,8 @@ export declare const QuestionPoolDiscriminatorSchema: z.ZodObject<{
         opportunityId: string;
         side: string;
     }[];
+    embedding?: number[] | undefined;
+    embeddingModel?: string | undefined;
 }, {
     label: string;
     questionSeed: string;
@@ -278,6 +286,8 @@ export declare const QuestionPoolDiscriminatorSchema: z.ZodObject<{
         opportunityId: string;
         side: string;
     }[];
+    embedding?: number[] | undefined;
+    embeddingModel?: string | undefined;
 }>;
 /** Pool snapshot stored on pool_discovery questions (server-side only). */
 export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
@@ -288,6 +298,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
     runId: z.ZodOptional<z.ZodString>;
     /** Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. */
     intentText: z.ZodOptional<z.ZodString>;
+    /** Stable hash of the full normalized payload + summary used for freshness. */
+    intentFingerprint: z.ZodOptional<z.ZodString>;
     /** The discriminator this question asks about. */
     discriminator: z.ZodObject<{
         label: z.ZodString;
@@ -297,6 +309,10 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
         sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
         voi: z.ZodNumber;
         evidenceRate: z.ZodNumber;
+        /** Discriminator embedding retained for durable semantic novelty checks. */
+        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        /** Model that generated `embedding`; mismatches must fall back to text. */
+        embeddingModel: z.ZodOptional<z.ZodString>;
         /** Verified assignments only — the P3 re-rank input. */
         assignments: z.ZodArray<z.ZodObject<{
             opportunityId: z.ZodString;
@@ -319,6 +335,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     }, {
         label: string;
         questionSeed: string;
@@ -330,6 +348,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     }>;
     /** Remaining ranked discriminators for interview-mode chaining. */
     alternates: z.ZodArray<z.ZodObject<{
@@ -340,6 +360,10 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
         sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
         voi: z.ZodNumber;
         evidenceRate: z.ZodNumber;
+        /** Discriminator embedding retained for durable semantic novelty checks. */
+        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        /** Model that generated `embedding`; mismatches must fall back to text. */
+        embeddingModel: z.ZodOptional<z.ZodString>;
         /** Verified assignments only — the P3 re-rank input. */
         assignments: z.ZodArray<z.ZodObject<{
             opportunityId: z.ZodString;
@@ -362,6 +386,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     }, {
         label: string;
         questionSeed: string;
@@ -373,6 +399,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     poolSize: number;
@@ -388,6 +416,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     };
     alternates: {
         label: string;
@@ -400,9 +430,12 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     }[];
     runId?: string | undefined;
     intentText?: string | undefined;
+    intentFingerprint?: string | undefined;
 }, {
     poolSize: number;
     minedAt: string;
@@ -417,6 +450,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     };
     alternates: {
         label: string;
@@ -429,13 +464,18 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
             opportunityId: string;
             side: string;
         }[];
+        embedding?: number[] | undefined;
+        embeddingModel?: string | undefined;
     }[];
     runId?: string | undefined;
     intentText?: string | undefined;
+    intentFingerprint?: string | undefined;
 }>;
 export declare const QuestionDetectionSchema: z.ZodObject<{
     /** Which preset mode generated this question. */
     mode: z.ZodEnum<["discovery", "intent", "enrichment", "negotiation", "negotiation_inflight", "chat", "pool_discovery"]>;
+    /** Internal reason for generation; independent of mode and QUD repair metadata. */
+    purpose: z.ZodOptional<z.ZodEnum<["uptake"]>>;
     /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
     sourceType: z.ZodString;
     /** ID of the triggering entity. */
@@ -462,6 +502,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
         runId: z.ZodOptional<z.ZodString>;
         /** Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. */
         intentText: z.ZodOptional<z.ZodString>;
+        /** Stable hash of the full normalized payload + summary used for freshness. */
+        intentFingerprint: z.ZodOptional<z.ZodString>;
         /** The discriminator this question asks about. */
         discriminator: z.ZodObject<{
             label: z.ZodString;
@@ -471,6 +513,10 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
             sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
             voi: z.ZodNumber;
             evidenceRate: z.ZodNumber;
+            /** Discriminator embedding retained for durable semantic novelty checks. */
+            embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            /** Model that generated `embedding`; mismatches must fall back to text. */
+            embeddingModel: z.ZodOptional<z.ZodString>;
             /** Verified assignments only — the P3 re-rank input. */
             assignments: z.ZodArray<z.ZodObject<{
                 opportunityId: z.ZodString;
@@ -493,6 +539,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }, {
             label: string;
             questionSeed: string;
@@ -504,6 +552,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }>;
         /** Remaining ranked discriminators for interview-mode chaining. */
         alternates: z.ZodArray<z.ZodObject<{
@@ -514,6 +564,10 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
             sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
             voi: z.ZodNumber;
             evidenceRate: z.ZodNumber;
+            /** Discriminator embedding retained for durable semantic novelty checks. */
+            embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            /** Model that generated `embedding`; mismatches must fall back to text. */
+            embeddingModel: z.ZodOptional<z.ZodString>;
             /** Verified assignments only — the P3 re-rank input. */
             assignments: z.ZodArray<z.ZodObject<{
                 opportunityId: z.ZodString;
@@ -536,6 +590,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }, {
             label: string;
             questionSeed: string;
@@ -547,6 +603,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         poolSize: number;
@@ -562,6 +620,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         };
         alternates: {
             label: string;
@@ -574,9 +634,12 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
         intentText?: string | undefined;
+        intentFingerprint?: string | undefined;
     }, {
         poolSize: number;
         minedAt: string;
@@ -591,6 +654,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         };
         alternates: {
             label: string;
@@ -603,9 +668,12 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
         intentText?: string | undefined;
+        intentFingerprint?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     mode: "intent" | "chat" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -614,6 +682,7 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
     timestamp: string;
     strategy?: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge" | undefined;
     underspecificationType?: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null | undefined;
+    purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
     messageId?: string | undefined;
     pool?: {
@@ -630,6 +699,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         };
         alternates: {
             label: string;
@@ -642,9 +713,12 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
         intentText?: string | undefined;
+        intentFingerprint?: string | undefined;
     } | undefined;
 }, {
     mode: "intent" | "chat" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -653,6 +727,7 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
     timestamp: string;
     strategy?: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge" | undefined;
     underspecificationType?: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null | undefined;
+    purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
     messageId?: string | undefined;
     pool?: {
@@ -669,6 +744,8 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         };
         alternates: {
             label: string;
@@ -681,9 +758,12 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
                 opportunityId: string;
                 side: string;
             }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
         intentText?: string | undefined;
+        intentFingerprint?: string | undefined;
     } | undefined;
 }>;
 export declare const QuestionActorSchema: z.ZodObject<{
@@ -722,6 +802,7 @@ export declare const QuestionAnswerSchema: z.ZodObject<{
     answeredAt: string;
     freeText?: string | undefined;
 }>;
+export type QuestionPurpose = z.infer<typeof QuestionPurposeSchema>;
 export type QuestionMode = z.infer<typeof QuestionModeSchema>;
 export type QuestionDetection = z.infer<typeof QuestionDetectionSchema>;
 export type QuestionActor = z.infer<typeof QuestionActorSchema>;

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

	@@ -1 +1 @@
1	- {"version":3,"file":"question.schema.d.ts","sourceRoot":"/","sources":["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;;IAE1E;;;;OAIG;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,kFAIvC,CAAC;AAEH,eAAO,MAAM,sBAAsB,oIAMjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;IA/BrC,+EAA+E;;IAE/E,yDAAyD;;IAEzD,6EAA6E;;QAX7E,+EAA+E;;QAE/E,iFAAiF;;;;;;;;;IAWjF,0EAA0E;;IAE1E;;;;OAIG;;;;IAqBH,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;EAE1F,CAAC;AAEH,eAAO,MAAM,+BAA+B;;QArC1C,+EAA+E;;QAE/E,yDAAyD;;QAEzD,6EAA6E;;YAX7E,+EAA+E;;YAE/E,iFAAiF;;;;;;;;;QAWjF,0EAA0E;;QAE1E;;;;WAIG;;;;QAqBH,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM1F,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,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,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;IAC/B,uBAAuB,EAAE,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CAC/D;AAID,eAAO,MAAM,kBAAkB,mHAa7B,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B;;;;;;;;;EAGvC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B;;;;IAI1C,gDAAgD;;;;IAIhD,wDAAwD~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~EAExD,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B;;IAErC,6CAA6C;;IAE7C,wDAAwD;;IAExD,yFAAyF;;IAEzF,kDAAkD;;;;;~~QAjBlD~~,gDAAgD;;;;QAIhD,wDAAwD~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAexD~~,mEAAmE;;;;;~~QAnBnE~~,gDAAgD;;;;QAIhD,wDAAwD~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBxD~~,CAAC;AAEH,eAAO,MAAM,uBAAuB;IAClC,iDAAiD;;IAEjD,uFAAuF;;IAEvF,mCAAmC;;IAEnC,kDAAkD;;IAElD,wCAAwC;;IAExC,0DAA0D;;IAE1D,0DAA0D;;IAE1D,yHAAyH;;IAEzH;;;OAGG;;;~~QAhCH~~,6CAA6C;;QAE7C,wDAAwD;;QAExD,yFAAyF;;QAEzF,kDAAkD;;;;;~~YAjBlD~~,gDAAgD;;;;YAIhD,wDAAwD~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAexD~~,mEAAmE;;;;;~~YAnBnE~~,gDAAgD;;;;YAIhD,wDAAwD~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCxD~~,CAAC;AAEH,eAAO,MAAM,mBAAmB;IAC9B,qCAAqC;;IAErC,gCAAgC;;IAEhC,iEAAiE;;;;;;;;;;EAEjE,CAAC;AAEH,eAAO,MAAM,oBAAoB;IAC/B,uCAAuC;;IAEvC,iEAAiE;;IAEjE,+BAA+B;;IAE/B,2DAA2D;;;;;;;;;;;;EAE3D,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
1	+ {"version":3,"file":"question.schema.d.ts","sourceRoot":"/","sources":["shared/schemas/question.schema.ts"],"names":[],"mappings":"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"}

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

@@ -53,6 +53,8 @@ export const QuestionGeneratorResponseSchema = z.object({
     questions: z.array(QuestionWithStrategySchema).max(3),
 });
 // ─── Persistence types (opportunity-style composable jsonb) ──────────────────
+/** Internal reason a question was generated, orthogonal to mode and QUD metadata. */
+export const QuestionPurposeSchema = z.enum(["uptake"]);
 export const QuestionModeSchema = z.enum([
     "discovery",
     "intent",
@@ -86,6 +88,10 @@ export const QuestionPoolDiscriminatorSchema = z.object({
     sideCounts: z.record(z.string(), z.number()),
     voi: z.number(),
     evidenceRate: z.number(),
+    /** Discriminator embedding retained for durable semantic novelty checks. */
+    embedding: z.array(z.number().finite()).min(1).max(4096).optional(),
+    /** Model that generated `embedding`; mismatches must fall back to text. */
+    embeddingModel: z.string().min(1).optional(),
     /** Verified assignments only — the P3 re-rank input. */
     assignments: z.array(QuestionPoolAssignmentSchema),
 });
@@ -98,6 +104,8 @@ export const QuestionPoolSnapshotSchema = z.object({
     runId: z.string().optional(),
     /** Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. */
     intentText: z.string().optional(),
+    /** Stable hash of the full normalized payload + summary used for freshness. */
+    intentFingerprint: z.string().min(1).optional(),
     /** The discriminator this question asks about. */
     discriminator: QuestionPoolDiscriminatorSchema,
     /** Remaining ranked discriminators for interview-mode chaining. */
@@ -106,6 +114,8 @@ export const QuestionPoolSnapshotSchema = z.object({
 export const QuestionDetectionSchema = z.object({
     /** Which preset mode generated this question. */
     mode: QuestionModeSchema,
+    /** Internal reason for generation; independent of mode and QUD repair metadata. */
+    purpose: QuestionPurposeSchema.optional(),
     /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
     sourceType: z.string().min(1),
     /** ID of the triggering entity. */

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

	@@ -1 +1 @@
1	- {"version":3,"file":"question.schema.js","sourceRoot":"/","sources":["shared/schemas/question.schema.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Question — public structured shape consumed by frontend renderers and MCP\n * elicitation dispatch. Mirrors the brainstorming AskUserQuestion skill so a\n * Question can be rendered identically across surfaces.\n \n `QuestionWithStrategy` extends the public shape with internal `strategy`\n * and QUD underspecification tags used by generator guardrails and persisted\n * metadata. Both tags are stripped before the public payload leaves the\n * generator — users never see them.\n /\nimport { z } from \"zod\";\n\nexport const QuestionOptionSchema = z.object({\n /* Display text. Suffix \" (Recommended)\" on the safest path; list it first. /\n label: z.string().min(1).max(120),\n /* Explains the consequence of choosing this option, not just its definition. /\n description: z.string().min(1).max(280),\n});\n\nexport const QuestionSchema = z.object({\n /* ≤12 chars. Noun of the decision domain — e.g. \"Stage\", \"Timing\", \"Role\". /\n title: z.string().min(1).max(12),\n /* ≤2 sentences, ≤400 chars. Ends in a question mark. /\n prompt: z.string().min(1).max(400),\n /* 2–4 options. No explicit \"Other\" — clients provide that automatically. /\n options: z.array(QuestionOptionSchema).min(2).max(4),\n /* True when options are not mutually exclusive (priorities, bundles). /\n multiSelect: z.boolean(),\n /\n Optional provenance line rendered as a muted chip above the prompt\n * (e.g. \"based on 18 people matching this intent\"). Aggregate counts only —\n * never individual identities (pool_discovery k-anonymity invariant).\n /\n evidence: z.string().min(1).max(160).optional(),\n});\n\n/* Canonical QUD repair categories for underspecified intents/questions. /\nexport const UnderspecificationTypeSchema = z.enum([\n \"missing_constituent\",\n \"missing_constraint\",\n \"open_alternative_set\",\n]);\n\nexport const QuestionStrategySchema = z.enum([\n \"refine_intent\",\n \"surface_missing_detail\",\n \"open_adjacent_thread\",\n \"reflective_summary\",\n \"surface_emergent_knowledge\",\n]);\n\nexport const QuestionWithStrategySchema = QuestionSchema.extend({\n strategy: QuestionStrategySchema,\n /* QUD repair category, or null when the question is not an underspecification repair. /\n underspecificationType: UnderspecificationTypeSchema.nullable(),\n});\n\nexport const QuestionGeneratorResponseSchema = z.object({\n questions: z.array(QuestionWithStrategySchema).max(3),\n});\n\nexport type QuestionOption = z.infer<typeof QuestionOptionSchema>;\nexport type Question = z.infer<typeof QuestionSchema>;\nexport type UnderspecificationType = z.infer<typeof UnderspecificationTypeSchema>;\nexport type QuestionStrategy = z.infer<typeof QuestionStrategySchema>;\nexport type QuestionWithStrategy = z.infer<typeof QuestionWithStrategySchema>;\nexport type QuestionGeneratorResponse = z.infer<typeof QuestionGeneratorResponseSchema>;\n\n/\n Internal generator output: public questions plus parallel strategy and QUD\n * taxonomy arrays for metadata-only consumption. The generator emits this;\n * callers forward only `questions` to renderers.\n /\nexport interface QuestionGenerationResult {\n questions: Question[];\n strategies: QuestionStrategy[];\n underspecificationTypes: Array<UnderspecificationType \| null>;\n}\n\n// ─── Persistence types (opportunity-style composable jsonb) ──────────────────\n\nexport const QuestionModeSchema = z.enum([\n \"discovery\",\n \"intent\",\n \"enrichment\",\n \"negotiation\",\n // Negotiator-initiated mid-negotiation client questions (ask_user action, P3).\n // Distinct from \"negotiation\", which covers post-stall questions only.\n \"negotiation_inflight\",\n // Orchestrator-initiated mid-conversation questions (ask_user_question tool).\n \"chat\",\n // Pool-discriminator questions mined from the intent's candidate pool\n // (IND-418). Synthesized deterministically — no generator LLM call.\n \"pool_discovery\",\n]);\n\n/* One server-side candidate→side assignment (never serialized to clients). /\nexport const QuestionPoolAssignmentSchema = z.object({\n opportunityId: z.string().min(1),\n side: z.string().min(1),\n});\n\n/\n One mined discriminator carried inside a pool_discovery question's\n * detection (the asked one plus ranked alternates for interview-mode\n * chaining). INTERNAL — the read path strips `detection.pool` before any\n * payload leaves the server.\n /\nexport const QuestionPoolDiscriminatorSchema = z.object({\n label: z.string().min(1),\n questionSeed: z.string().min(1),\n sides: z.array(z.string().min(1)).min(2).max(3),\n /* Verified-assignment count per side label. /\n sideCounts: z.record(z.string(), z.number()),\n voi: z.number(),\n evidenceRate: z.number(),\n /* Verified assignments only — the P3 re-rank input. /\n assignments: z.array(QuestionPoolAssignmentSchema),\n});\n\n/* Pool snapshot stored on pool_discovery questions (server-side only). /\nexport const QuestionPoolSnapshotSchema = z.object({\n poolSize: z.number().int().min(0),\n /* ISO-8601 timestamp of the mining pass. /\n minedAt: z.string().min(1),\n /* Discovery run that produced the pool, when known. /\n runId: z.string().optional(),\n /* Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. /\n intentText: z.string().optional(),\n /* The discriminator this question asks about. /\n discriminator: QuestionPoolDiscriminatorSchema,\n /* Remaining ranked discriminators for interview-mode chaining. /\n alternates: z.array(QuestionPoolDiscriminatorSchema),\n});\n\nexport const QuestionDetectionSchema = z.object({\n /* Which preset mode generated this question. /\n mode: QuestionModeSchema,\n /* Entity type that triggered generation (e.g. \"opportunity\", \"intent\", \"profile\"). /\n sourceType: z.string().min(1),\n /* ID of the triggering entity. /\n sourceId: z.string().min(1),\n /* Optional intent ID that was the root cause. /\n triggeredBy: z.string().optional(),\n /* ISO-8601 timestamp of generation. /\n timestamp: z.string().min(1),\n /* Generation strategy persisted as internal metadata. /\n strategy: QuestionStrategySchema.optional(),\n /* QUD repair category persisted as internal metadata. /\n underspecificationType: UnderspecificationTypeSchema.nullable().optional(),\n /* ID of the assistant message that triggered this question. Used by the frontend to anchor the question card inline. /\n messageId: z.string().optional(),\n /\n pool_discovery only: the mined pool snapshot (assignments + alternates).\n * INTERNAL — stripped from every client-facing read (web + MCP).\n /\n pool: QuestionPoolSnapshotSchema.optional(),\n});\n\nexport const QuestionActorSchema = z.object({\n /* The user this question is for. /\n userId: z.string().min(1),\n /* Optional network context. /\n networkId: z.string().optional(),\n /* Actor's role in the question — currently always \"subject\". /\n role: z.literal(\"subject\"),\n});\n\nexport const QuestionAnswerSchema = z.object({\n /* Option labels the user selected. /\n selectedOptions: z.array(z.string()),\n /* Free-text input when the user chose \"Other\" or elaborated. /\n freeText: z.string().optional(),\n /* User ID of the answerer. /\n answeredBy: z.string().min(1),\n /* ISO-8601 timestamp of when the answer was submitted. */\n answeredAt: z.string().min(1),\n});\n\nexport type QuestionMode = z.infer<typeof QuestionModeSchema>;\nexport type QuestionDetection = z.infer<typeof QuestionDetectionSchema>;\nexport type QuestionActor = z.infer<typeof QuestionActorSchema>;\nexport type QuestionAnswer = z.infer<typeof QuestionAnswerSchema>;\nexport type QuestionPoolAssignment = z.infer<typeof QuestionPoolAssignmentSchema>;\nexport type QuestionPoolDiscriminator = z.infer<typeof QuestionPoolDiscriminatorSchema>;\nexport type QuestionPoolSnapshot = z.infer<typeof QuestionPoolSnapshotSchema>;\n"]}
1	+ {"version":3,"file":"question.schema.js","sourceRoot":"/","sources":["shared/schemas/question.schema.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Question — public structured shape consumed by frontend renderers and MCP\n * elicitation dispatch. Mirrors the brainstorming AskUserQuestion skill so a\n * Question can be rendered identically across surfaces.\n \n `QuestionWithStrategy` extends the public shape with internal `strategy`\n * and QUD underspecification tags used by generator guardrails and persisted\n * metadata. Both tags are stripped before the public payload leaves the\n * generator — users never see them.\n /\nimport { z } from \"zod\";\n\nexport const QuestionOptionSchema = z.object({\n /* Display text. Suffix \" (Recommended)\" on the safest path; list it first. /\n label: z.string().min(1).max(120),\n /* Explains the consequence of choosing this option, not just its definition. /\n description: z.string().min(1).max(280),\n});\n\nexport const QuestionSchema = z.object({\n /* ≤12 chars. Noun of the decision domain — e.g. \"Stage\", \"Timing\", \"Role\". /\n title: z.string().min(1).max(12),\n /* ≤2 sentences, ≤400 chars. Ends in a question mark. /\n prompt: z.string().min(1).max(400),\n /* 2–4 options. No explicit \"Other\" — clients provide that automatically. /\n options: z.array(QuestionOptionSchema).min(2).max(4),\n /* True when options are not mutually exclusive (priorities, bundles). /\n multiSelect: z.boolean(),\n /\n Optional provenance line rendered as a muted chip above the prompt\n * (e.g. \"based on 18 people matching this intent\"). Aggregate counts only —\n * never individual identities (pool_discovery k-anonymity invariant).\n /\n evidence: z.string().min(1).max(160).optional(),\n});\n\n/* Canonical QUD repair categories for underspecified intents/questions. /\nexport const UnderspecificationTypeSchema = z.enum([\n \"missing_constituent\",\n \"missing_constraint\",\n \"open_alternative_set\",\n]);\n\nexport const QuestionStrategySchema = z.enum([\n \"refine_intent\",\n \"surface_missing_detail\",\n \"open_adjacent_thread\",\n \"reflective_summary\",\n \"surface_emergent_knowledge\",\n]);\n\nexport const QuestionWithStrategySchema = QuestionSchema.extend({\n strategy: QuestionStrategySchema,\n /* QUD repair category, or null when the question is not an underspecification repair. /\n underspecificationType: UnderspecificationTypeSchema.nullable(),\n});\n\nexport const QuestionGeneratorResponseSchema = z.object({\n questions: z.array(QuestionWithStrategySchema).max(3),\n});\n\nexport type QuestionOption = z.infer<typeof QuestionOptionSchema>;\nexport type Question = z.infer<typeof QuestionSchema>;\nexport type UnderspecificationType = z.infer<typeof UnderspecificationTypeSchema>;\nexport type QuestionStrategy = z.infer<typeof QuestionStrategySchema>;\nexport type QuestionWithStrategy = z.infer<typeof QuestionWithStrategySchema>;\nexport type QuestionGeneratorResponse = z.infer<typeof QuestionGeneratorResponseSchema>;\n\n/\n Internal generator output: public questions plus parallel strategy and QUD\n * taxonomy arrays for metadata-only consumption. The generator emits this;\n * callers forward only `questions` to renderers.\n /\nexport interface QuestionGenerationResult {\n questions: Question[];\n strategies: QuestionStrategy[];\n underspecificationTypes: Array<UnderspecificationType \| null>;\n}\n\n// ─── Persistence types (opportunity-style composable jsonb) ──────────────────\n\n/* Internal reason a question was generated, orthogonal to mode and QUD metadata. /\nexport const QuestionPurposeSchema = z.enum([\"uptake\"]);\n\nexport const QuestionModeSchema = z.enum([\n \"discovery\",\n \"intent\",\n \"enrichment\",\n \"negotiation\",\n // Negotiator-initiated mid-negotiation client questions (ask_user action, P3).\n // Distinct from \"negotiation\", which covers post-stall questions only.\n \"negotiation_inflight\",\n // Orchestrator-initiated mid-conversation questions (ask_user_question tool).\n \"chat\",\n // Pool-discriminator questions mined from the intent's candidate pool\n // (IND-418). Synthesized deterministically — no generator LLM call.\n \"pool_discovery\",\n]);\n\n/* One server-side candidate→side assignment (never serialized to clients). /\nexport const QuestionPoolAssignmentSchema = z.object({\n opportunityId: z.string().min(1),\n side: z.string().min(1),\n});\n\n/\n One mined discriminator carried inside a pool_discovery question's\n * detection (the asked one plus ranked alternates for interview-mode\n * chaining). INTERNAL — the read path strips `detection.pool` before any\n * payload leaves the server.\n /\nexport const QuestionPoolDiscriminatorSchema = z.object({\n label: z.string().min(1),\n questionSeed: z.string().min(1),\n sides: z.array(z.string().min(1)).min(2).max(3),\n /* Verified-assignment count per side label. /\n sideCounts: z.record(z.string(), z.number()),\n voi: z.number(),\n evidenceRate: z.number(),\n /* Discriminator embedding retained for durable semantic novelty checks. /\n embedding: z.array(z.number().finite()).min(1).max(4096).optional(),\n /* Model that generated `embedding`; mismatches must fall back to text. /\n embeddingModel: z.string().min(1).optional(),\n /* Verified assignments only — the P3 re-rank input. /\n assignments: z.array(QuestionPoolAssignmentSchema),\n});\n\n/* Pool snapshot stored on pool_discovery questions (server-side only). /\nexport const QuestionPoolSnapshotSchema = z.object({\n poolSize: z.number().int().min(0),\n /* ISO-8601 timestamp of the mining pass. /\n minedAt: z.string().min(1),\n /* Discovery run that produced the pool, when known. /\n runId: z.string().optional(),\n /* Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. /\n intentText: z.string().optional(),\n /* Stable hash of the full normalized payload + summary used for freshness. /\n intentFingerprint: z.string().min(1).optional(),\n /* The discriminator this question asks about. /\n discriminator: QuestionPoolDiscriminatorSchema,\n /* Remaining ranked discriminators for interview-mode chaining. /\n alternates: z.array(QuestionPoolDiscriminatorSchema),\n});\n\nexport const QuestionDetectionSchema = z.object({\n /* Which preset mode generated this question. /\n mode: QuestionModeSchema,\n /* Internal reason for generation; independent of mode and QUD repair metadata. /\n purpose: QuestionPurposeSchema.optional(),\n /* Entity type that triggered generation (e.g. \"opportunity\", \"intent\", \"profile\"). /\n sourceType: z.string().min(1),\n /* ID of the triggering entity. /\n sourceId: z.string().min(1),\n /* Optional intent ID that was the root cause. /\n triggeredBy: z.string().optional(),\n /* ISO-8601 timestamp of generation. /\n timestamp: z.string().min(1),\n /* Generation strategy persisted as internal metadata. /\n strategy: QuestionStrategySchema.optional(),\n /* QUD repair category persisted as internal metadata. /\n underspecificationType: UnderspecificationTypeSchema.nullable().optional(),\n /* ID of the assistant message that triggered this question. Used by the frontend to anchor the question card inline. /\n messageId: z.string().optional(),\n /\n pool_discovery only: the mined pool snapshot (assignments + alternates).\n * INTERNAL — stripped from every client-facing read (web + MCP).\n /\n pool: QuestionPoolSnapshotSchema.optional(),\n});\n\nexport const QuestionActorSchema = z.object({\n /* The user this question is for. /\n userId: z.string().min(1),\n /* Optional network context. /\n networkId: z.string().optional(),\n /* Actor's role in the question — currently always \"subject\". /\n role: z.literal(\"subject\"),\n});\n\nexport const QuestionAnswerSchema = z.object({\n /* Option labels the user selected. /\n selectedOptions: z.array(z.string()),\n /* Free-text input when the user chose \"Other\" or elaborated. /\n freeText: z.string().optional(),\n /* User ID of the answerer. /\n answeredBy: z.string().min(1),\n /* ISO-8601 timestamp of when the answer was submitted. */\n answeredAt: z.string().min(1),\n});\n\nexport type QuestionPurpose = z.infer<typeof QuestionPurposeSchema>;\nexport type QuestionMode = z.infer<typeof QuestionModeSchema>;\nexport type QuestionDetection = z.infer<typeof QuestionDetectionSchema>;\nexport type QuestionActor = z.infer<typeof QuestionActorSchema>;\nexport type QuestionAnswer = z.infer<typeof QuestionAnswerSchema>;\nexport type QuestionPoolAssignment = z.infer<typeof QuestionPoolAssignmentSchema>;\nexport type QuestionPoolDiscriminator = z.infer<typeof QuestionPoolDiscriminatorSchema>;\nexport type QuestionPoolSnapshot = z.infer<typeof QuestionPoolSnapshotSchema>;\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "4.11.0-rc.351.1",
+  "version": "4.13.0-rc.353.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",