@indexnetwork/protocol 6.7.1-rc.393.1 → 6.8.0-rc.395.1

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

@@ -220,7 +220,7 @@ export interface QuestionGenerationResult {
     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 QuestionPurposeSchema: z.ZodEnum<["uptake", "recovery"]>;
 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<{
@@ -521,15 +521,37 @@ export declare const QuestionPoolPushSchema: z.ZodObject<{
 }>;
 /** Durable request state for proactive pool-question delivery. */
 export declare const QuestionPoolPushRequestStatusSchema: z.ZodEnum<["requested", "suppressed"]>;
-/** Internal reason a pending pool question was voided. */
-export declare const QuestionVoidedReasonSchema: z.ZodEnum<["pool_drift", "intent_edit"]>;
+/** Private snapshot for a post-discovery recovery refinement question. */
+export declare const QuestionRecoverySnapshotSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    intentFingerprint: z.ZodString;
+    completionSource: z.ZodEnum<["from_intent", "discovery_run"]>;
+    /** Privacy-safe aggregate only; raw negotiation evidence is never persisted. */
+    rejectedNegotiationCount: z.ZodOptional<z.ZodNumber>;
+    /** Bounded internal correlation id for an asynchronous discovery run. */
+    runId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    intentFingerprint: string;
+    version: 1;
+    completionSource: "from_intent" | "discovery_run";
+    runId?: string | undefined;
+    rejectedNegotiationCount?: number | undefined;
+}, {
+    intentFingerprint: string;
+    version: 1;
+    completionSource: "from_intent" | "discovery_run";
+    runId?: string | undefined;
+    rejectedNegotiationCount?: number | undefined;
+}>;
+/** Internal reason a pending question was voided. */
+export declare const QuestionVoidedReasonSchema: z.ZodEnum<["pool_drift", "intent_edit", "recovery_drift"]>;
 /** Permanent reasons that terminalize an unclaimed proactive push request. */
 export declare const QuestionPoolPushRequestReasonSchema: z.ZodEnum<["question_lifecycle", "intent_lifecycle", "malformed_source", "malformed_actor", "malformed_pool", "malformed_cycle", "visited", "pool_size", "voi", "cycle_budget"]>;
 export declare const QuestionDetectionSchema: z.ZodEffects<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"]>>;
+    purpose: z.ZodOptional<z.ZodEnum<["uptake", "recovery"]>>;
     /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
     sourceType: z.ZodString;
     /** ID of the triggering entity. */
@@ -733,6 +755,28 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentFingerprint?: string | undefined;
         opportunityIds?: string[] | undefined;
     }>>;
+    /** Post-discovery intent recovery snapshot. Internal only. */
+    recovery: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        intentFingerprint: z.ZodString;
+        completionSource: z.ZodEnum<["from_intent", "discovery_run"]>;
+        /** Privacy-safe aggregate only; raw negotiation evidence is never persisted. */
+        rejectedNegotiationCount: z.ZodOptional<z.ZodNumber>;
+        /** Bounded internal correlation id for an asynchronous discovery run. */
+        runId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        intentFingerprint: string;
+        version: 1;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    }, {
+        intentFingerprint: string;
+        version: 1;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    }>>;
     /** Durable request marker written before enqueueing proactive delivery. Internal only. */
     pushRequestedAt: z.ZodOptional<z.ZodString>;
     /** Last bounded recovery sweep that selected this request. Internal only. */
@@ -788,7 +832,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         failure?: string | undefined;
     }>>;
     /** Internal reason this question was voided after pool or intent drift. */
-    voidedReason: z.ZodOptional<z.ZodEnum<["pool_drift", "intent_edit"]>>;
+    voidedReason: z.ZodOptional<z.ZodEnum<["pool_drift", "intent_edit", "recovery_drift"]>>;
     /** Authoritative successful-delivery ledger timestamp. Internal only. */
     pushedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -813,8 +857,15 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     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;
+    recovery?: {
+        intentFingerprint: string;
+        version: 1;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
+    purpose?: "uptake" | "recovery" | undefined;
     triggeredBy?: string | undefined;
     pool?: {
         poolSize: number;
@@ -857,7 +908,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     pushRequestStatus?: "suppressed" | "requested" | undefined;
     pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
     pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -881,8 +932,15 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     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;
+    recovery?: {
+        intentFingerprint: string;
+        version: 1;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
+    purpose?: "uptake" | "recovery" | undefined;
     triggeredBy?: string | undefined;
     pool?: {
         poolSize: number;
@@ -925,7 +983,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     pushRequestStatus?: "suppressed" | "requested" | undefined;
     pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
     pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | undefined;
     pushedAt?: string | undefined;
 }>, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -949,8 +1007,15 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     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;
+    recovery?: {
+        intentFingerprint: string;
+        version: 1;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
+    purpose?: "uptake" | "recovery" | undefined;
     triggeredBy?: string | undefined;
     pool?: {
         poolSize: number;
@@ -993,7 +1058,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     pushRequestStatus?: "suppressed" | "requested" | undefined;
     pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
     pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -1017,8 +1082,15 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     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;
+    recovery?: {
+        intentFingerprint: string;
+        version: 1;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
+    purpose?: "uptake" | "recovery" | undefined;
     triggeredBy?: string | undefined;
     pool?: {
         poolSize: number;
@@ -1061,7 +1133,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     pushRequestStatus?: "suppressed" | "requested" | undefined;
     pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
     pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | undefined;
     pushedAt?: string | undefined;
 }>;
 export declare const QuestionActorSchema: z.ZodObject<{
@@ -1108,6 +1180,7 @@ export type QuestionAnswer = z.infer<typeof QuestionAnswerSchema>;
 export type QuestionPoolAssignment = z.infer<typeof QuestionPoolAssignmentSchema>;
 export type QuestionPoolDiscriminator = z.infer<typeof QuestionPoolDiscriminatorSchema>;
 export type QuestionPoolSnapshot = z.infer<typeof QuestionPoolSnapshotSchema>;
+export type QuestionRecoverySnapshot = z.infer<typeof QuestionRecoverySnapshotSchema>;
 export type QuestionPoolPush = z.infer<typeof QuestionPoolPushSchema>;
 export type QuestionVoidedReason = z.infer<typeof QuestionVoidedReasonSchema>;
 export type QuestionPoolPushRequestStatus = z.infer<typeof QuestionPoolPushRequestStatusSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"question.schema.d.ts","sourceRoot":"/","sources":["shared/schemas/question.schema.ts"],"names":[],"mappings":"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"}
+{"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

@@ -54,7 +54,7 @@ export const QuestionGeneratorResponseSchema = z.object({
 });
 // ─── 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 QuestionPurposeSchema = z.enum(["uptake", "recovery"]);
 export const QuestionModeSchema = z.enum([
     "discovery",
     "intent",
@@ -134,8 +134,18 @@ export const QuestionPoolPushSchema = z.object({
 });
 /** Durable request state for proactive pool-question delivery. */
 export const QuestionPoolPushRequestStatusSchema = z.enum(["requested", "suppressed"]);
-/** Internal reason a pending pool question was voided. */
-export const QuestionVoidedReasonSchema = z.enum(["pool_drift", "intent_edit"]);
+/** Private snapshot for a post-discovery recovery refinement question. */
+export const QuestionRecoverySnapshotSchema = z.object({
+    version: z.literal(1),
+    intentFingerprint: z.string().regex(/^[a-f0-9]{64}$/),
+    completionSource: z.enum(["from_intent", "discovery_run"]),
+    /** Privacy-safe aggregate only; raw negotiation evidence is never persisted. */
+    rejectedNegotiationCount: z.number().int().min(1).max(50).optional(),
+    /** Bounded internal correlation id for an asynchronous discovery run. */
+    runId: z.string().min(1).max(128).optional(),
+});
+/** Internal reason a pending question was voided. */
+export const QuestionVoidedReasonSchema = z.enum(["pool_drift", "intent_edit", "recovery_drift"]);
 /** Permanent reasons that terminalize an unclaimed proactive push request. */
 export const QuestionPoolPushRequestReasonSchema = z.enum([
     "question_lifecycle",
@@ -173,6 +183,8 @@ export const QuestionDetectionSchema = z.object({
      * INTERNAL — stripped from every client-facing read (web + MCP).
      */
     pool: QuestionPoolSnapshotSchema.optional(),
+    /** Post-discovery intent recovery snapshot. Internal only. */
+    recovery: QuestionRecoverySnapshotSchema.optional(),
     /** Durable request marker written before enqueueing proactive delivery. Internal only. */
     pushRequestedAt: z.string().min(1).optional(),
     /** Last bounded recovery sweep that selected this request. Internal only. */
@@ -198,6 +210,26 @@ export const QuestionDetectionSchema = z.object({
             message: "pool_discovery triggeredBy must be non-empty and equal sourceId",
         });
     }
+    if (detection.purpose === "recovery") {
+        if (detection.mode !== "intent"
+            || detection.sourceType !== "intent"
+            || !detection.triggeredBy?.trim()
+            || detection.triggeredBy !== detection.sourceId
+            || !detection.recovery) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["recovery"],
+                message: "recovery purpose requires intent mode/source, equal trigger provenance, and a recovery snapshot",
+            });
+        }
+    }
+    else if (detection.recovery) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["purpose"],
+            message: "recovery snapshot requires recovery purpose",
+        });
+    }
     if (detection.pushRequestStatus && !detection.pushRequestedAt) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,

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

@@ -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\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  /** Exact bounded candidate pool. Optional for legacy rows/jobs created before IND-422. */\n  opportunityIds: z.array(z.string().uuid()).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\n/** Internal delivery ledger for proactive pool-question pushes (IND-421). */\nexport const QuestionPoolPushSchema = z.object({\n  version: z.literal(1),\n  source: z.literal(\"pool_discovery\"),\n  recipientId: z.string().min(1),\n  intentId: z.string().min(1),\n  cycleKey: z.string().min(1),\n  messageId: z.string().min(1),\n  surfaces: z.tuple([\n    z.literal(\"personal_agent_badge\"),\n    z.literal(\"negotiator_dm\"),\n  ]),\n  claimedAt: z.string().min(1),\n  deliveryStatus: z.enum([\"claimed\", \"delivered\", \"suppressed\", \"failed\"]),\n  conversationId: z.string().min(1).optional(),\n  deliveredAt: z.string().min(1).optional(),\n  suppressedAt: z.string().min(1).optional(),\n  failure: z.string().min(1).max(500).optional(),\n});\n\n/** Durable request state for proactive pool-question delivery. */\nexport const QuestionPoolPushRequestStatusSchema = z.enum([\"requested\", \"suppressed\"]);\n\n/** Internal reason a pending pool question was voided. */\nexport const QuestionVoidedReasonSchema = z.enum([\"pool_drift\", \"intent_edit\"]);\n\n/** Permanent reasons that terminalize an unclaimed proactive push request. */\nexport const QuestionPoolPushRequestReasonSchema = z.enum([\n  \"question_lifecycle\",\n  \"intent_lifecycle\",\n  \"malformed_source\",\n  \"malformed_actor\",\n  \"malformed_pool\",\n  \"malformed_cycle\",\n  \"visited\",\n  \"pool_size\",\n  \"voi\",\n  \"cycle_budget\",\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  /** Durable request marker written before enqueueing proactive delivery. Internal only. */\n  pushRequestedAt: z.string().min(1).optional(),\n  /** Last bounded recovery sweep that selected this request. Internal only. */\n  pushRecoveryAttemptedAt: z.string().min(1).optional(),\n  /** Durable request outcome. Internal only. */\n  pushRequestStatus: QuestionPoolPushRequestStatusSchema.optional(),\n  /** Permanent suppression reason for an unclaimed request. Internal only. */\n  pushRequestReason: QuestionPoolPushRequestReasonSchema.optional(),\n  /** ISO-8601 timestamp at which an unclaimed request was suppressed. Internal only. */\n  pushRequestSuppressedAt: z.string().min(1).optional(),\n  /** Internal proactive delivery state. Never serialize to public clients. */\n  push: QuestionPoolPushSchema.optional(),\n  /** Internal reason this question was voided after pool or intent drift. */\n  voidedReason: QuestionVoidedReasonSchema.optional(),\n  /** Authoritative successful-delivery ledger timestamp. Internal only. */\n  pushedAt: z.string().min(1).optional(),\n}).superRefine((detection, ctx) => {\n  if (\n    detection.mode === \"pool_discovery\"\n    && (!detection.triggeredBy?.trim() || detection.triggeredBy !== detection.sourceId)\n  ) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"triggeredBy\"],\n      message: \"pool_discovery triggeredBy must be non-empty and equal sourceId\",\n    });\n  }\n  if (detection.pushRequestStatus && !detection.pushRequestedAt) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"pushRequestedAt\"],\n      message: \"push request state requires a request timestamp\",\n    });\n  }\n  if (detection.pushRecoveryAttemptedAt && !detection.pushRequestedAt) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"pushRequestedAt\"],\n      message: \"push recovery attempts require a request timestamp\",\n    });\n  }\n  if (detection.pushRequestStatus === \"suppressed\") {\n    if (!detection.pushRequestReason) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: [\"pushRequestReason\"],\n        message: \"suppressed push requests require a reason\",\n      });\n    }\n    if (!detection.pushRequestSuppressedAt) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: [\"pushRequestSuppressedAt\"],\n        message: \"suppressed push requests require a timestamp\",\n      });\n    }\n  }\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>;\nexport type QuestionPoolPush = z.infer<typeof QuestionPoolPushSchema>;\nexport type QuestionVoidedReason = z.infer<typeof QuestionVoidedReasonSchema>;\nexport type QuestionPoolPushRequestStatus = z.infer<typeof QuestionPoolPushRequestStatusSchema>;\nexport type QuestionPoolPushRequestReason = z.infer<typeof QuestionPoolPushRequestReasonSchema>;\n"]}
+{"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\", \"recovery\"]);\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  /** Exact bounded candidate pool. Optional for legacy rows/jobs created before IND-422. */\n  opportunityIds: z.array(z.string().uuid()).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\n/** Internal delivery ledger for proactive pool-question pushes (IND-421). */\nexport const QuestionPoolPushSchema = z.object({\n  version: z.literal(1),\n  source: z.literal(\"pool_discovery\"),\n  recipientId: z.string().min(1),\n  intentId: z.string().min(1),\n  cycleKey: z.string().min(1),\n  messageId: z.string().min(1),\n  surfaces: z.tuple([\n    z.literal(\"personal_agent_badge\"),\n    z.literal(\"negotiator_dm\"),\n  ]),\n  claimedAt: z.string().min(1),\n  deliveryStatus: z.enum([\"claimed\", \"delivered\", \"suppressed\", \"failed\"]),\n  conversationId: z.string().min(1).optional(),\n  deliveredAt: z.string().min(1).optional(),\n  suppressedAt: z.string().min(1).optional(),\n  failure: z.string().min(1).max(500).optional(),\n});\n\n/** Durable request state for proactive pool-question delivery. */\nexport const QuestionPoolPushRequestStatusSchema = z.enum([\"requested\", \"suppressed\"]);\n\n/** Private snapshot for a post-discovery recovery refinement question. */\nexport const QuestionRecoverySnapshotSchema = z.object({\n  version: z.literal(1),\n  intentFingerprint: z.string().regex(/^[a-f0-9]{64}$/),\n  completionSource: z.enum([\"from_intent\", \"discovery_run\"]),\n  /** Privacy-safe aggregate only; raw negotiation evidence is never persisted. */\n  rejectedNegotiationCount: z.number().int().min(1).max(50).optional(),\n  /** Bounded internal correlation id for an asynchronous discovery run. */\n  runId: z.string().min(1).max(128).optional(),\n});\n\n/** Internal reason a pending question was voided. */\nexport const QuestionVoidedReasonSchema = z.enum([\"pool_drift\", \"intent_edit\", \"recovery_drift\"]);\n\n/** Permanent reasons that terminalize an unclaimed proactive push request. */\nexport const QuestionPoolPushRequestReasonSchema = z.enum([\n  \"question_lifecycle\",\n  \"intent_lifecycle\",\n  \"malformed_source\",\n  \"malformed_actor\",\n  \"malformed_pool\",\n  \"malformed_cycle\",\n  \"visited\",\n  \"pool_size\",\n  \"voi\",\n  \"cycle_budget\",\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  /** Post-discovery intent recovery snapshot. Internal only. */\n  recovery: QuestionRecoverySnapshotSchema.optional(),\n  /** Durable request marker written before enqueueing proactive delivery. Internal only. */\n  pushRequestedAt: z.string().min(1).optional(),\n  /** Last bounded recovery sweep that selected this request. Internal only. */\n  pushRecoveryAttemptedAt: z.string().min(1).optional(),\n  /** Durable request outcome. Internal only. */\n  pushRequestStatus: QuestionPoolPushRequestStatusSchema.optional(),\n  /** Permanent suppression reason for an unclaimed request. Internal only. */\n  pushRequestReason: QuestionPoolPushRequestReasonSchema.optional(),\n  /** ISO-8601 timestamp at which an unclaimed request was suppressed. Internal only. */\n  pushRequestSuppressedAt: z.string().min(1).optional(),\n  /** Internal proactive delivery state. Never serialize to public clients. */\n  push: QuestionPoolPushSchema.optional(),\n  /** Internal reason this question was voided after pool or intent drift. */\n  voidedReason: QuestionVoidedReasonSchema.optional(),\n  /** Authoritative successful-delivery ledger timestamp. Internal only. */\n  pushedAt: z.string().min(1).optional(),\n}).superRefine((detection, ctx) => {\n  if (\n    detection.mode === \"pool_discovery\"\n    && (!detection.triggeredBy?.trim() || detection.triggeredBy !== detection.sourceId)\n  ) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"triggeredBy\"],\n      message: \"pool_discovery triggeredBy must be non-empty and equal sourceId\",\n    });\n  }\n  if (detection.purpose === \"recovery\") {\n    if (\n      detection.mode !== \"intent\"\n      || detection.sourceType !== \"intent\"\n      || !detection.triggeredBy?.trim()\n      || detection.triggeredBy !== detection.sourceId\n      || !detection.recovery\n    ) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: [\"recovery\"],\n        message: \"recovery purpose requires intent mode/source, equal trigger provenance, and a recovery snapshot\",\n      });\n    }\n  } else if (detection.recovery) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"purpose\"],\n      message: \"recovery snapshot requires recovery purpose\",\n    });\n  }\n  if (detection.pushRequestStatus && !detection.pushRequestedAt) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"pushRequestedAt\"],\n      message: \"push request state requires a request timestamp\",\n    });\n  }\n  if (detection.pushRecoveryAttemptedAt && !detection.pushRequestedAt) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"pushRequestedAt\"],\n      message: \"push recovery attempts require a request timestamp\",\n    });\n  }\n  if (detection.pushRequestStatus === \"suppressed\") {\n    if (!detection.pushRequestReason) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: [\"pushRequestReason\"],\n        message: \"suppressed push requests require a reason\",\n      });\n    }\n    if (!detection.pushRequestSuppressedAt) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: [\"pushRequestSuppressedAt\"],\n        message: \"suppressed push requests require a timestamp\",\n      });\n    }\n  }\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>;\nexport type QuestionRecoverySnapshot = z.infer<typeof QuestionRecoverySnapshotSchema>;\nexport type QuestionPoolPush = z.infer<typeof QuestionPoolPushSchema>;\nexport type QuestionVoidedReason = z.infer<typeof QuestionVoidedReasonSchema>;\nexport type QuestionPoolPushRequestStatus = z.infer<typeof QuestionPoolPushRequestStatusSchema>;\nexport type QuestionPoolPushRequestReason = z.infer<typeof QuestionPoolPushRequestReasonSchema>;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "6.7.1-rc.393.1",
+  "version": "6.8.0-rc.395.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",