@indexnetwork/protocol 13.0.0-rc.464.1 → 13.2.0-rc.466.1

package/CHANGELOG.md

@@ -20,6 +20,16 @@ went 6.7.1 → 8.0.2 with no 7.x in between because the whole 7.x line shipped a
 prereleases between the two promotions. To track every change, read `rc`; to
 pin a supported release, use `latest`.
 
+## 13.2.0 - 2026-08-16
+
+### Added
+
+- `retired_mode` to `QuestionVoidedReasonSchema`, marking rows whose generating
+  mode was removed. Written only by the one-time
+  `0127_dismiss_retired_discovery_questions` migration — no runtime path emits
+  it, since a retired mode produces nothing by definition. The marker makes the
+  cleanup auditable and exactly reversible.
+
 ## 13.0.0 - 2026-08-13
 
 ### Removed

package/dist/questions/domain/question.schema.d.ts

@@ -661,7 +661,15 @@ export declare const QuestionPoolPushSchema: z.ZodObject<{
     intentId: z.ZodString;
     cycleKey: z.ZodString;
     messageId: z.ZodString;
-    surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodLiteral<"negotiator_dm">], null>;
+    /**
+     * Where a claimed push is delivered. The second slot names the negotiator
+     * surface: new claims write `negotiator_intent_chat` (the intent-pinned
+     * session). `negotiator_dm` is the legacy literal for rows persisted before
+     * the unscoped DM was removed — this schema is validated on read, so the
+     * union keeps those rows parsing instead of rejecting them. Read-compat
+     * only; nothing writes it.
+     */
+    surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodUnion<[z.ZodLiteral<"negotiator_intent_chat">, z.ZodLiteral<"negotiator_dm">]>], null>;
     claimedAt: z.ZodString;
     deliveryStatus: z.ZodEnum<["claimed", "delivered", "suppressed", "failed"]>;
     conversationId: z.ZodOptional<z.ZodString>;
@@ -675,7 +683,7 @@ export declare const QuestionPoolPushSchema: z.ZodObject<{
     intentId: string;
     cycleKey: string;
     messageId: string;
-    surfaces: ["personal_agent_badge", "negotiator_dm"];
+    surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
     claimedAt: string;
     deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
     conversationId?: string | undefined;
@@ -689,7 +697,7 @@ export declare const QuestionPoolPushSchema: z.ZodObject<{
     intentId: string;
     cycleKey: string;
     messageId: string;
-    surfaces: ["personal_agent_badge", "negotiator_dm"];
+    surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
     claimedAt: string;
     deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
     conversationId?: string | undefined;
@@ -722,7 +730,7 @@ export declare const QuestionRecoverySnapshotSchema: z.ZodObject<{
     rejectedNegotiationCount?: number | undefined;
 }>;
 /** Internal reason a pending question was voided. */
-export declare const QuestionVoidedReasonSchema: z.ZodEnum<["pool_drift", "intent_edit", "recovery_drift", "negotiation_stale"]>;
+export declare const QuestionVoidedReasonSchema: z.ZodEnum<["pool_drift", "intent_edit", "recovery_drift", "negotiation_stale", "retired_mode"]>;
 /** 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<{
@@ -1064,7 +1072,15 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentId: z.ZodString;
         cycleKey: z.ZodString;
         messageId: z.ZodString;
-        surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodLiteral<"negotiator_dm">], null>;
+        /**
+         * Where a claimed push is delivered. The second slot names the negotiator
+         * surface: new claims write `negotiator_intent_chat` (the intent-pinned
+         * session). `negotiator_dm` is the legacy literal for rows persisted before
+         * the unscoped DM was removed — this schema is validated on read, so the
+         * union keeps those rows parsing instead of rejecting them. Read-compat
+         * only; nothing writes it.
+         */
+        surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodUnion<[z.ZodLiteral<"negotiator_intent_chat">, z.ZodLiteral<"negotiator_dm">]>], null>;
         claimedAt: z.ZodString;
         deliveryStatus: z.ZodEnum<["claimed", "delivered", "suppressed", "failed"]>;
         conversationId: z.ZodOptional<z.ZodString>;
@@ -1078,7 +1094,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentId: string;
         cycleKey: string;
         messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
         claimedAt: string;
         deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
         conversationId?: string | undefined;
@@ -1092,7 +1108,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentId: string;
         cycleKey: string;
         messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
         claimedAt: string;
         deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
         conversationId?: string | undefined;
@@ -1101,7 +1117,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", "negotiation_stale"]>>;
+    voidedReason: z.ZodOptional<z.ZodEnum<["pool_drift", "intent_edit", "recovery_drift", "negotiation_stale", "retired_mode"]>>;
     /** Authoritative successful-delivery ledger timestamp. Internal only. */
     pushedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -1116,7 +1132,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentId: string;
         cycleKey: string;
         messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
         claimedAt: string;
         deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
         conversationId?: string | undefined;
@@ -1196,7 +1212,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" | "negotiation_stale" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -1210,7 +1226,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentId: string;
         cycleKey: string;
         messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
         claimedAt: string;
         deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
         conversationId?: string | undefined;
@@ -1290,7 +1306,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" | "negotiation_stale" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
     pushedAt?: string | undefined;
 }>, {
     mode: "chat" | "intent" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -1304,7 +1320,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentId: string;
         cycleKey: string;
         messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
         claimedAt: string;
         deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
         conversationId?: string | undefined;
@@ -1384,7 +1400,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" | "negotiation_stale" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
     pushedAt?: string | undefined;
 }, {
     mode: "chat" | "intent" | "negotiation" | "negotiation_inflight" | "pool_discovery";
@@ -1398,7 +1414,7 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         intentId: string;
         cycleKey: string;
         messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
         claimedAt: string;
         deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
         conversationId?: string | undefined;
@@ -1478,7 +1494,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" | "negotiation_stale" | undefined;
+    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
     pushedAt?: string | undefined;
 }>;
 export declare const QuestionActorSchema: z.ZodObject<{

package/dist/questions/domain/question.schema.js

@@ -225,9 +225,17 @@ export const QuestionPoolPushSchema = z.object({
     intentId: z.string().min(1),
     cycleKey: z.string().min(1),
     messageId: z.string().min(1),
+    /**
+     * Where a claimed push is delivered. The second slot names the negotiator
+     * surface: new claims write `negotiator_intent_chat` (the intent-pinned
+     * session). `negotiator_dm` is the legacy literal for rows persisted before
+     * the unscoped DM was removed — this schema is validated on read, so the
+     * union keeps those rows parsing instead of rejecting them. Read-compat
+     * only; nothing writes it.
+     */
     surfaces: z.tuple([
         z.literal("personal_agent_badge"),
-        z.literal("negotiator_dm"),
+        z.union([z.literal("negotiator_intent_chat"), z.literal("negotiator_dm")]),
     ]),
     claimedAt: z.string().min(1),
     deliveryStatus: z.enum(["claimed", "delivered", "suppressed", "failed"]),
@@ -254,6 +262,10 @@ export const QuestionVoidedReasonSchema = z.enum([
     "intent_edit",
     "recovery_drift",
     "negotiation_stale",
+    // The generator that produced the row was retired, so the question can no
+    // longer lead anywhere. Written once by a one-time migration, never by
+    // runtime code — nothing produces a retired mode by definition.
+    "retired_mode",
 ]);
 /** Permanent reasons that terminalize an unclaimed proactive push request. */
 export const QuestionPoolPushRequestReasonSchema = z.enum([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "13.0.0-rc.464.1",
+  "version": "13.2.0-rc.466.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",