@indexnetwork/protocol 6.7.1 → 6.9.0-rc.396.1

package/dist/shared/interfaces/negotiation-events.interface.d.ts

@@ -46,11 +46,23 @@ export interface NegotiationTimeoutQueue {
 }
 /** Payload carried by an ask_user answer-window expiry job. */
 export interface AskUserExpiryPayload {
+    /** Deterministic durable settlement/outbox key for this exact paused task. */
+    settlementId: string;
     /** Opportunity to resume via the run-existing continuation path. */
     opportunityId: string;
     /** The asking side's client (the user who was asked and did not answer). */
     userId: string;
-    /** What the negotiator wanted permission to share / needed to know. */
-    disclosureSubject: string;
+    /** Exact owned signal consulted by the paused negotiator. */
+    recipientIntentId: string;
+    /** Exact non-personal network shared by the opportunity actors. */
+    networkId: string;
+    /** Admission-time canonical hash of the recipient intent payload/summary. */
+    intentFingerprint: string;
+    /** Admission-time opportunity lifecycle marker. */
+    opportunityStatus: string;
+    opportunityUpdatedAt: string;
+    /** Exact counterparty provenance for settlement-time eligibility checks. */
+    counterpartyUserId: string;
+    counterpartyIntentId: string;
 }
 //# sourceMappingURL=negotiation-events.interface.d.ts.map

package/dist/shared/interfaces/negotiation-events.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"negotiation-events.interface.d.ts","sourceRoot":"/","sources":["shared/interfaces/negotiation-events.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5F;;;OAGG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAAC,CACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"negotiation-events.interface.d.ts","sourceRoot":"/","sources":["shared/interfaces/negotiation-events.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5F;;;OAGG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAAC,CACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/shared/interfaces/negotiation-events.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"negotiation-events.interface.js","sourceRoot":"/","sources":["shared/interfaces/negotiation-events.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG","sourcesContent":["/**\n * Interfaces for negotiation yield/resume support.\n * Used by the negotiation graph and dispatcher to manage timeouts\n * for external agents that haven't responded yet.\n */\n\n/**\n * Manages delayed timeout jobs for negotiations waiting on external agents.\n * When a negotiation yields, a timeout is enqueued. If the external agent\n * responds before the timeout, the job is cancelled.\n */\nexport interface NegotiationTimeoutQueue {\n  /**\n   * Enqueue a delayed timeout job.\n   * @param negotiationId - The negotiation task ID\n   * @param turnNumber - Current turn number (used to detect stale jobs)\n   * @param delayMs - Delay in milliseconds before the timeout fires\n   * @returns The BullMQ job ID for cancellation\n   */\n  enqueueTimeout(negotiationId: string, turnNumber: number, delayMs: number): Promise<string>;\n\n  /**\n   * Cancel a pending timeout job for a negotiation.\n   * @param negotiationId - The negotiation task ID\n   */\n  cancelTimeout(negotiationId: string): Promise<void>;\n\n  /**\n   * Arm the answer-window timer for an `ask_user` pause (P3.2). Fires after\n   * `delayMs` (typically 24 h); the worker resumes the negotiation with a\n   * conservative no-disclosure default when the task is still\n   * `input_required`, and no-ops otherwise (stale job).\n   *\n   * Optional so fakes and pre-P3.2 implementations stay valid; the graph only\n   * offers `ask_user` when this method is present.\n   *\n   * @param negotiationId - The paused negotiation task ID\n   * @param payload - Resume coordinates + observability context\n   * @param delayMs - Delay before the expiry fires\n   * @returns The job ID for cancellation\n   */\n  enqueueAskUserExpiry?(\n    negotiationId: string,\n    payload: AskUserExpiryPayload,\n    delayMs: number,\n  ): Promise<string>;\n\n  /**\n   * Cancel a pending ask_user answer-window timer (the client answered in\n   * time, or the negotiation reached a terminal state another way).\n   * @param negotiationId - The paused negotiation task ID\n   */\n  cancelAskUserExpiry?(negotiationId: string): Promise<void>;\n}\n\n/** Payload carried by an ask_user answer-window expiry job. */\nexport interface AskUserExpiryPayload {\n  /** Opportunity to resume via the run-existing continuation path. */\n  opportunityId: string;\n  /** The asking side's client (the user who was asked and did not answer). */\n  userId: string;\n  /** What the negotiator wanted permission to share / needed to know. */\n  disclosureSubject: string;\n}\n"]}
+{"version":3,"file":"negotiation-events.interface.js","sourceRoot":"/","sources":["shared/interfaces/negotiation-events.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG","sourcesContent":["/**\n * Interfaces for negotiation yield/resume support.\n * Used by the negotiation graph and dispatcher to manage timeouts\n * for external agents that haven't responded yet.\n */\n\n/**\n * Manages delayed timeout jobs for negotiations waiting on external agents.\n * When a negotiation yields, a timeout is enqueued. If the external agent\n * responds before the timeout, the job is cancelled.\n */\nexport interface NegotiationTimeoutQueue {\n  /**\n   * Enqueue a delayed timeout job.\n   * @param negotiationId - The negotiation task ID\n   * @param turnNumber - Current turn number (used to detect stale jobs)\n   * @param delayMs - Delay in milliseconds before the timeout fires\n   * @returns The BullMQ job ID for cancellation\n   */\n  enqueueTimeout(negotiationId: string, turnNumber: number, delayMs: number): Promise<string>;\n\n  /**\n   * Cancel a pending timeout job for a negotiation.\n   * @param negotiationId - The negotiation task ID\n   */\n  cancelTimeout(negotiationId: string): Promise<void>;\n\n  /**\n   * Arm the answer-window timer for an `ask_user` pause (P3.2). Fires after\n   * `delayMs` (typically 24 h); the worker resumes the negotiation with a\n   * conservative no-disclosure default when the task is still\n   * `input_required`, and no-ops otherwise (stale job).\n   *\n   * Optional so fakes and pre-P3.2 implementations stay valid; the graph only\n   * offers `ask_user` when this method is present.\n   *\n   * @param negotiationId - The paused negotiation task ID\n   * @param payload - Resume coordinates + observability context\n   * @param delayMs - Delay before the expiry fires\n   * @returns The job ID for cancellation\n   */\n  enqueueAskUserExpiry?(\n    negotiationId: string,\n    payload: AskUserExpiryPayload,\n    delayMs: number,\n  ): Promise<string>;\n\n  /**\n   * Cancel a pending ask_user answer-window timer (the client answered in\n   * time, or the negotiation reached a terminal state another way).\n   * @param negotiationId - The paused negotiation task ID\n   */\n  cancelAskUserExpiry?(negotiationId: string): Promise<void>;\n}\n\n/** Payload carried by an ask_user answer-window expiry job. */\nexport interface AskUserExpiryPayload {\n  /** Deterministic durable settlement/outbox key for this exact paused task. */\n  settlementId: string;\n  /** Opportunity to resume via the run-existing continuation path. */\n  opportunityId: string;\n  /** The asking side's client (the user who was asked and did not answer). */\n  userId: string;\n  /** Exact owned signal consulted by the paused negotiator. */\n  recipientIntentId: string;\n  /** Exact non-personal network shared by the opportunity actors. */\n  networkId: string;\n  /** Admission-time canonical hash of the recipient intent payload/summary. */\n  intentFingerprint: string;\n  /** Admission-time opportunity lifecycle marker. */\n  opportunityStatus: string;\n  opportunityUpdatedAt: string;\n  /** Exact counterparty provenance for settlement-time eligibility checks. */\n  counterpartyUserId: string;\n  counterpartyIntentId: string;\n}\n"]}

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

@@ -220,7 +220,156 @@ 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 NegotiationQuestionPurposeSchema: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
+export declare const QuestionPurposeSchema: z.ZodEnum<["uptake", "recovery", "stalled_followup", "inflight_consultation"]>;
+/**
+ * Producer-supplied candidate binding. The API re-resolves every field from
+ * authoritative rows before generation; callers cannot mint provenance.
+ */
+export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObject<{
+    purpose: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
+    recipientUserId: z.ZodString;
+    recipientIntentId: z.ZodString;
+    opportunityId: z.ZodString;
+    taskId: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodString;
+    /** Uptake only: exact low-authority counterparty eligibility binding. */
+    counterpartyUserId: z.ZodOptional<z.ZodString>;
+    counterpartyIntentId: z.ZodOptional<z.ZodString>;
+    counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+}, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+}>, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+}, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+}>;
+/**
+ * Durable server-only routing and freshness envelope for negotiation-family
+ * questions. This object is stripped from every REST/MCP projection.
+ */
+export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    purpose: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
+    recipientUserId: z.ZodString;
+    recipientIntentId: z.ZodString;
+    opportunityId: z.ZodString;
+    taskId: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodString;
+    intentFingerprint: z.ZodString;
+    opportunityStatus: z.ZodEnum<["latent", "draft", "negotiating", "pending", "stalled", "accepted", "rejected", "expired"]>;
+    opportunityUpdatedAt: z.ZodString;
+    taskState: z.ZodOptional<z.ZodEnum<["submitted", "working", "input_required", "completed", "canceled", "failed", "rejected", "auth_required", "waiting_for_agent", "claimed"]>>;
+    taskUpdatedAt: z.ZodOptional<z.ZodString>;
+    /** Uptake only: exact low-authority counterparty eligibility binding. */
+    counterpartyUserId: z.ZodOptional<z.ZodString>;
+    counterpartyIntentId: z.ZodOptional<z.ZodString>;
+    counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
+    /** Stable per-generation position so retries dedupe without reducing cardinality. */
+    questionOrdinal: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    version: 1;
+    intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
+    questionOrdinal: number;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+    taskUpdatedAt?: string | undefined;
+}, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    version: 1;
+    intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
+    questionOrdinal: number;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+    taskUpdatedAt?: string | undefined;
+}>, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    version: 1;
+    intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
+    questionOrdinal: number;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+    taskUpdatedAt?: string | undefined;
+}, {
+    networkId: string;
+    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+    recipientUserId: string;
+    recipientIntentId: string;
+    opportunityId: string;
+    version: 1;
+    intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
+    questionOrdinal: number;
+    taskId?: string | undefined;
+    counterpartyUserId?: string | undefined;
+    counterpartyIntentId?: string | undefined;
+    counterpartyFelicityAuthority?: number | undefined;
+    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+    taskUpdatedAt?: string | undefined;
+}>;
 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<{
@@ -436,8 +585,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
         embeddingModel?: string | undefined;
     }[];
     runId?: string | undefined;
-    intentText?: string | undefined;
     intentFingerprint?: string | undefined;
+    intentText?: string | undefined;
     opportunityIds?: string[] | undefined;
 }, {
     poolSize: number;
@@ -471,8 +620,8 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
         embeddingModel?: string | undefined;
     }[];
     runId?: string | undefined;
-    intentText?: string | undefined;
     intentFingerprint?: string | undefined;
+    intentText?: string | undefined;
     opportunityIds?: string[] | undefined;
 }>;
 /** Internal delivery ledger for proactive pool-question pushes (IND-421). */
@@ -521,15 +670,126 @@ 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, {
+    version: 1;
+    intentFingerprint: string;
+    completionSource: "from_intent" | "discovery_run";
+    runId?: string | undefined;
+    rejectedNegotiationCount?: number | undefined;
+}, {
+    version: 1;
+    intentFingerprint: string;
+    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", "negotiation_stale"]>;
 /** 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", "stalled_followup", "inflight_consultation"]>>;
+    /** Exact negotiation recipient/intent/task routing provenance. Internal only. */
+    negotiation: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        purpose: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
+        recipientUserId: z.ZodString;
+        recipientIntentId: z.ZodString;
+        opportunityId: z.ZodString;
+        taskId: z.ZodOptional<z.ZodString>;
+        networkId: z.ZodString;
+        intentFingerprint: z.ZodString;
+        opportunityStatus: z.ZodEnum<["latent", "draft", "negotiating", "pending", "stalled", "accepted", "rejected", "expired"]>;
+        opportunityUpdatedAt: z.ZodString;
+        taskState: z.ZodOptional<z.ZodEnum<["submitted", "working", "input_required", "completed", "canceled", "failed", "rejected", "auth_required", "waiting_for_agent", "claimed"]>>;
+        taskUpdatedAt: z.ZodOptional<z.ZodString>;
+        /** Uptake only: exact low-authority counterparty eligibility binding. */
+        counterpartyUserId: z.ZodOptional<z.ZodString>;
+        counterpartyIntentId: z.ZodOptional<z.ZodString>;
+        counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
+        /** Stable per-generation position so retries dedupe without reducing cardinality. */
+        questionOrdinal: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    }, {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    }>, {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    }, {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    }>>;
     /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
     sourceType: z.ZodString;
     /** ID of the triggering entity. */
@@ -544,6 +804,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     underspecificationType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["missing_constituent", "missing_constraint", "open_alternative_set"]>>>;
     /** ID of the assistant message that triggered this question. Used by the frontend to anchor the question card inline. */
     messageId: z.ZodOptional<z.ZodString>;
+    /** Durable server-only conversation session binding used to validate messageId. */
+    sessionId: z.ZodOptional<z.ZodString>;
     /**
      * pool_discovery only: the mined pool snapshot (assignments + alternates).
      * INTERNAL — stripped from every client-facing read (web + MCP).
@@ -694,8 +956,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
             embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
-        intentText?: string | undefined;
         intentFingerprint?: string | undefined;
+        intentText?: string | undefined;
         opportunityIds?: string[] | undefined;
     }, {
         poolSize: number;
@@ -729,10 +991,32 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
             embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
-        intentText?: string | undefined;
         intentFingerprint?: string | undefined;
+        intentText?: 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, {
+        version: 1;
+        intentFingerprint: string;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    }, {
+        version: 1;
+        intentFingerprint: string;
+        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 +1072,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", "negotiation_stale"]>>;
     /** Authoritative successful-delivery ledger timestamp. Internal only. */
     pushedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -813,9 +1097,35 @@ 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?: {
+        version: 1;
+        intentFingerprint: string;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
+    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
+    negotiation?: {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -848,8 +1158,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
             embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
-        intentText?: string | undefined;
         intentFingerprint?: string | undefined;
+        intentText?: string | undefined;
         opportunityIds?: string[] | undefined;
     } | undefined;
     pushRequestedAt?: string | undefined;
@@ -857,7 +1167,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" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -881,9 +1191,35 @@ 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?: {
+        version: 1;
+        intentFingerprint: string;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
+    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
+    negotiation?: {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -916,8 +1252,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
             embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
-        intentText?: string | undefined;
         intentFingerprint?: string | undefined;
+        intentText?: string | undefined;
         opportunityIds?: string[] | undefined;
     } | undefined;
     pushRequestedAt?: string | undefined;
@@ -925,7 +1261,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" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }>, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -949,9 +1285,35 @@ 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?: {
+        version: 1;
+        intentFingerprint: string;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
+    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
+    negotiation?: {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -984,8 +1346,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
             embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
-        intentText?: string | undefined;
         intentFingerprint?: string | undefined;
+        intentText?: string | undefined;
         opportunityIds?: string[] | undefined;
     } | undefined;
     pushRequestedAt?: string | undefined;
@@ -993,7 +1355,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" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -1017,9 +1379,35 @@ 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?: {
+        version: 1;
+        intentFingerprint: string;
+        completionSource: "from_intent" | "discovery_run";
+        runId?: string | undefined;
+        rejectedNegotiationCount?: number | undefined;
+    } | undefined;
+    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
+    negotiation?: {
+        networkId: string;
+        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
+        recipientUserId: string;
+        recipientIntentId: string;
+        opportunityId: string;
+        version: 1;
+        intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
+        questionOrdinal: number;
+        taskId?: string | undefined;
+        counterpartyUserId?: string | undefined;
+        counterpartyIntentId?: string | undefined;
+        counterpartyFelicityAuthority?: number | undefined;
+        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
+        taskUpdatedAt?: string | undefined;
+    } | undefined;
     messageId?: string | undefined;
-    purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -1052,8 +1440,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
             embeddingModel?: string | undefined;
         }[];
         runId?: string | undefined;
-        intentText?: string | undefined;
         intentFingerprint?: string | undefined;
+        intentText?: string | undefined;
         opportunityIds?: string[] | undefined;
     } | undefined;
     pushRequestedAt?: string | undefined;
@@ -1061,7 +1449,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" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }>;
 export declare const QuestionActorSchema: z.ZodObject<{
@@ -1100,6 +1488,9 @@ export declare const QuestionAnswerSchema: z.ZodObject<{
     answeredAt: string;
     freeText?: string | undefined;
 }>;
+export type NegotiationQuestionPurpose = z.infer<typeof NegotiationQuestionPurposeSchema>;
+export type NegotiationQuestionCandidate = z.infer<typeof NegotiationQuestionCandidateSchema>;
+export type NegotiationQuestionProvenance = z.infer<typeof NegotiationQuestionProvenanceSchema>;
 export type QuestionPurpose = z.infer<typeof QuestionPurposeSchema>;
 export type QuestionMode = z.infer<typeof QuestionModeSchema>;
 export type QuestionDetection = z.infer<typeof QuestionDetectionSchema>;
@@ -1108,6 +1499,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>;