@indexnetwork/protocol 6.8.0-rc.395.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", "recovery"]>;
+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). */
@@ -531,27 +680,116 @@ export declare const QuestionRecoverySnapshotSchema: z.ZodObject<{
     /** Bounded internal correlation id for an asynchronous discovery run. */
     runId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    intentFingerprint: string;
     version: 1;
+    intentFingerprint: string;
     completionSource: "from_intent" | "discovery_run";
     runId?: string | undefined;
     rejectedNegotiationCount?: number | undefined;
 }, {
-    intentFingerprint: string;
     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"]>;
+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", "recovery"]>>;
+    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. */
@@ -566,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).
@@ -716,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;
@@ -751,8 +991,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;
     }>>;
     /** Post-discovery intent recovery snapshot. Internal only. */
@@ -765,14 +1005,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         /** Bounded internal correlation id for an asynchronous discovery run. */
         runId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        intentFingerprint: string;
         version: 1;
+        intentFingerprint: string;
         completionSource: "from_intent" | "discovery_run";
         runId?: string | undefined;
         rejectedNegotiationCount?: number | undefined;
     }, {
-        intentFingerprint: string;
         version: 1;
+        intentFingerprint: string;
         completionSource: "from_intent" | "discovery_run";
         runId?: string | undefined;
         rejectedNegotiationCount?: number | undefined;
@@ -832,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", "recovery_drift"]>>;
+    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, {
@@ -858,15 +1098,34 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     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;
+        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" | "recovery" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -899,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;
@@ -908,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" | "recovery_drift" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -933,15 +1192,34 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     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;
+        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" | "recovery" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -974,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;
@@ -983,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" | "recovery_drift" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }>, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -1008,15 +1286,34 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     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;
+        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" | "recovery" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -1049,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;
@@ -1058,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" | "recovery_drift" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -1083,15 +1380,34 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     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;
+        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" | "recovery" | undefined;
     triggeredBy?: string | undefined;
+    sessionId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -1124,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;
@@ -1133,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" | "recovery_drift" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | undefined;
     pushedAt?: string | undefined;
 }>;
 export declare const QuestionActorSchema: z.ZodObject<{
@@ -1172,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>;