@indexnetwork/protocol 4.14.1-rc.355.1 → 4.15.0-rc.357.1

package/dist/opportunity/discriminator/discriminator.env.d.ts

@@ -25,6 +25,13 @@ export type PoolQuestionsMode = "off" | "on";
  * "on" implies mining runs even when POOL_QUESTIONS_MINING is off.
  */
 export declare function poolQuestionsMode(): PoolQuestionsMode;
+/** Push delivery mode for high-VoI pool questions (IND-421). */
+export type PoolQuestionsPushMode = "off" | "on";
+/**
+ * Current POOL_QUESTIONS_PUSH mode (default off). Callers must additionally
+ * require pool-question mode and negotiator availability before delivery.
+ */
+export declare function poolQuestionsPushMode(): PoolQuestionsPushMode;
 /** Newborn-opportunity stamping mode (IND-420 P4b). */
 export type PoolQuestionsStampNewbornMode = "off" | "on";
 /**
@@ -40,6 +47,14 @@ export declare const POOL_QUESTION_MIN_EVIDENCE_RATE = 0.6;
 export declare const POOL_QUESTION_MAX_DISCRIMINATORS = 3;
 /** Unattended budget: max pending questions of ANY mode per intent. */
 export declare const POOL_QUESTION_MAX_PENDING_PER_INTENT = 3;
+/** Initial internal VoI threshold for proactive push delivery. */
+export declare const POOL_QUESTION_PUSH_BASE_VOI = 0.6;
+/** Multiplicative VoI threshold increase per consecutive dismissal. */
+export declare const POOL_QUESTION_PUSH_DISMISSAL_DECAY = 1.15;
+/** Minimum pool size for proactive delivery (stricter than mining). */
+export declare const POOL_QUESTION_PUSH_MIN_POOL_SIZE = 8;
+/** Maximum claimed proactive pool pushes per recipient per UTC day. */
+export declare const POOL_QUESTION_PUSH_DAILY_CAP = 2;
 /** Ranking mode for pool adjustments (IND-419). */
 export type PoolQuestionsRankingMode = "off" | "on";
 /**

package/dist/opportunity/discriminator/discriminator.env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discriminator.env.d.ts","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvD,wDAAwD;AACxD,wBAAgB,uBAAuB,IAAI,uBAAuB,CAEjE;AAED,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,IAAI,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CAErD;AAED,uDAAuD;AACvD,MAAM,MAAM,6BAA6B,GAAG,KAAK,GAAG,IAAI,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,6BAA6B,CAEzE;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,uEAAuE;AACvE,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD,mDAAmD;AACnD,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG,IAAI,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,wBAAwB,CAE/D;AAED,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,6EAA6E;AAC7E,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,2CAA2C,MAAM,CAAC"}
+{"version":3,"file":"discriminator.env.d.ts","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvD,wDAAwD;AACxD,wBAAgB,uBAAuB,IAAI,uBAAuB,CAEjE;AAED,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,IAAI,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CAErD;AAED,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,IAAI,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,qBAAqB,CAE7D;AAED,uDAAuD;AACvD,MAAM,MAAM,6BAA6B,GAAG,KAAK,GAAG,IAAI,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,6BAA6B,CAEzE;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,uEAAuE;AACvE,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD,kEAAkE;AAClE,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,uEAAuE;AACvE,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAEvD,uEAAuE;AACvE,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,uEAAuE;AACvE,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,mDAAmD;AACnD,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG,IAAI,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,wBAAwB,CAE/D;AAED,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,6EAA6E;AAC7E,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,2CAA2C,MAAM,CAAC"}

package/dist/opportunity/discriminator/discriminator.env.js

@@ -25,6 +25,13 @@ export function poolQuestionsMiningMode() {
 export function poolQuestionsMode() {
     return process.env.POOL_QUESTIONS_MODE?.trim() === "on" ? "on" : "off";
 }
+/**
+ * Current POOL_QUESTIONS_PUSH mode (default off). Callers must additionally
+ * require pool-question mode and negotiator availability before delivery.
+ */
+export function poolQuestionsPushMode() {
+    return process.env.POOL_QUESTIONS_PUSH?.trim() === "on" ? "on" : "off";
+}
 /**
  * Current POOL_QUESTIONS_STAMP_NEWBORN mode (default off). Effective callers
  * additionally require {@link poolQuestionsMode} to be on.
@@ -40,6 +47,14 @@ export const POOL_QUESTION_MIN_EVIDENCE_RATE = 0.6;
 export const POOL_QUESTION_MAX_DISCRIMINATORS = 3;
 /** Unattended budget: max pending questions of ANY mode per intent. */
 export const POOL_QUESTION_MAX_PENDING_PER_INTENT = 3;
+/** Initial internal VoI threshold for proactive push delivery. */
+export const POOL_QUESTION_PUSH_BASE_VOI = 0.6;
+/** Multiplicative VoI threshold increase per consecutive dismissal. */
+export const POOL_QUESTION_PUSH_DISMISSAL_DECAY = 1.15;
+/** Minimum pool size for proactive delivery (stricter than mining). */
+export const POOL_QUESTION_PUSH_MIN_POOL_SIZE = 8;
+/** Maximum claimed proactive pool pushes per recipient per UTC day. */
+export const POOL_QUESTION_PUSH_DAILY_CAP = 2;
 /**
  * Current POOL_QUESTIONS_RANKING (default off). When "on", the home feed
  * orders by adjusted confidence (confidence × Π poolAdjustments.factor,

package/dist/opportunity/discriminator/discriminator.env.js.map

@@ -1 +1 @@
-{"version":3,"file":"discriminator.env.js","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,wDAAwD;AACxD,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AACnF,CAAC;AAKD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACzE,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAClF,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,mFAAmF;AACnF,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD,gFAAgF;AAChF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,uEAAuE;AACvE,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC;AAKtD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAM,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAEpD,qEAAqE;AACrE,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAAG,CAAC","sourcesContent":["/**\n * Centralized accessors for pool-question environment variables (IND-416).\n *\n *   POOL_QUESTIONS_MINING   off | shadow — P1 shadow axis mining on\n *                           discovery-run completion. `shadow` mines and\n *                           scores axes and logs them; no questions are\n *                           generated and no user-facing behavior changes.\n *                           Any value other than \"shadow\" (including unset)\n *                           means off.\n *\n * All reads go through this module — do not read these variables via\n * `process.env` elsewhere. Values are read on every call (no caching) so\n * tests and long-lived processes observe changes.\n */\n\n/** Mining mode for pool discriminator axes. */\nexport type PoolQuestionsMiningMode = \"off\" | \"shadow\";\n\n/** Current POOL_QUESTIONS_MINING mode (default off). */\nexport function poolQuestionsMiningMode(): PoolQuestionsMiningMode {\n  return process.env.POOL_QUESTIONS_MINING?.trim() === \"shadow\" ? \"shadow\" : \"off\";\n}\n\n/** Question mode for pool discriminators (IND-418). */\nexport type PoolQuestionsMode = \"off\" | \"on\";\n\n/**\n * Current POOL_QUESTIONS_MODE (default off). When \"on\", the mining hook also\n * enqueues a pool_discovery question for the top eligible discriminator\n * (still subject to the QUESTIONER_ENABLED master gate and per-intent budget).\n * \"on\" implies mining runs even when POOL_QUESTIONS_MINING is off.\n */\nexport function poolQuestionsMode(): PoolQuestionsMode {\n  return process.env.POOL_QUESTIONS_MODE?.trim() === \"on\" ? \"on\" : \"off\";\n}\n\n/** Newborn-opportunity stamping mode (IND-420 P4b). */\nexport type PoolQuestionsStampNewbornMode = \"off\" | \"on\";\n\n/**\n * Current POOL_QUESTIONS_STAMP_NEWBORN mode (default off). Effective callers\n * additionally require {@link poolQuestionsMode} to be on.\n */\nexport function poolQuestionsStampNewborn(): PoolQuestionsStampNewbornMode {\n  return process.env.POOL_QUESTIONS_STAMP_NEWBORN?.trim() === \"on\" ? \"on\" : \"off\";\n}\n\n/** Minimum VoI for a discriminator to become (or chain) a question. */\nexport const POOL_QUESTION_MIN_VOI = 0.2;\n\n/** Minimum evidence-verification rate for a discriminator to become a question. */\nexport const POOL_QUESTION_MIN_EVIDENCE_RATE = 0.6;\n\n/** Max eligible discriminators carried per mining pass (asked + alternates). */\nexport const POOL_QUESTION_MAX_DISCRIMINATORS = 3;\n\n/** Unattended budget: max pending questions of ANY mode per intent. */\nexport const POOL_QUESTION_MAX_PENDING_PER_INTENT = 3;\n\n/** Ranking mode for pool adjustments (IND-419). */\nexport type PoolQuestionsRankingMode = \"off\" | \"on\";\n\n/**\n * Current POOL_QUESTIONS_RANKING (default off). When \"on\", the home feed\n * orders by adjusted confidence (confidence × Π poolAdjustments.factor,\n * floor {@link POOL_ADJUSTMENT_FLOOR}). Adjustments are WRITTEN regardless of\n * this flag — it only gates whether ordering reads them, so the apply path\n * can ship first.\n */\nexport function poolQuestionsRanking(): PoolQuestionsRankingMode {\n  return process.env.POOL_QUESTIONS_RANKING?.trim() === \"on\" ? \"on\" : \"off\";\n}\n\n/** Adjustment factor for candidates on the side the user did NOT choose. */\nexport const POOL_ADJUSTMENT_FACTOR_OTHER = 0.6;\n\n/** Adjustment factor for candidates the miner could not assign (unknown). */\nexport const POOL_ADJUSTMENT_FACTOR_UNKNOWN = 0.9;\n\n/** Floor for the cumulative adjustment multiplier — demoted, never hidden. */\nexport const POOL_ADJUSTMENT_FLOOR = 0.3;\n\n/**\n * Staleness guard (IND-419): when more than this fraction of a question's\n * stored assignments point at opportunities that left the pool (expired /\n * rejected / accepted / archived), skip the re-rank — the snapshot no longer\n * describes the live pool.\n */\nexport const POOL_STALENESS_THRESHOLD = 0.3;\n\n/** Debounce window for answer-triggered re-discovery (Tier 1), per intent. */\nexport const POOL_RERUN_DEBOUNCE_MS = 60_000;\n\n/**\n * k-anonymity floor: axes are only mined when the pool has at least this many\n * candidates, so no axis (or later, question option) can be traced back to a\n * specific individual.\n */\nexport const POOL_DISCRIMINATOR_MIN_POOL_SIZE = 5;\n\n/** Max candidates sent to the miner LLM (top-N by score). */\nexport const POOL_DISCRIMINATOR_MAX_CANDIDATES = 24;\n\n/** Max chars of public context per candidate in the miner prompt. */\nexport const POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS = 400;\n"]}
+{"version":3,"file":"discriminator.env.js","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,wDAAwD;AACxD,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AACnF,CAAC;AAKD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACzE,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACzE,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAClF,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,mFAAmF;AACnF,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD,gFAAgF;AAChF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,uEAAuE;AACvE,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC;AAEtD,kEAAkE;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C,uEAAuE;AACvE,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,CAAC;AAEvD,uEAAuE;AACvE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,uEAAuE;AACvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAK9C;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAM,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAEpD,qEAAqE;AACrE,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAAG,CAAC","sourcesContent":["/**\n * Centralized accessors for pool-question environment variables (IND-416).\n *\n *   POOL_QUESTIONS_MINING   off | shadow — P1 shadow axis mining on\n *                           discovery-run completion. `shadow` mines and\n *                           scores axes and logs them; no questions are\n *                           generated and no user-facing behavior changes.\n *                           Any value other than \"shadow\" (including unset)\n *                           means off.\n *\n * All reads go through this module — do not read these variables via\n * `process.env` elsewhere. Values are read on every call (no caching) so\n * tests and long-lived processes observe changes.\n */\n\n/** Mining mode for pool discriminator axes. */\nexport type PoolQuestionsMiningMode = \"off\" | \"shadow\";\n\n/** Current POOL_QUESTIONS_MINING mode (default off). */\nexport function poolQuestionsMiningMode(): PoolQuestionsMiningMode {\n  return process.env.POOL_QUESTIONS_MINING?.trim() === \"shadow\" ? \"shadow\" : \"off\";\n}\n\n/** Question mode for pool discriminators (IND-418). */\nexport type PoolQuestionsMode = \"off\" | \"on\";\n\n/**\n * Current POOL_QUESTIONS_MODE (default off). When \"on\", the mining hook also\n * enqueues a pool_discovery question for the top eligible discriminator\n * (still subject to the QUESTIONER_ENABLED master gate and per-intent budget).\n * \"on\" implies mining runs even when POOL_QUESTIONS_MINING is off.\n */\nexport function poolQuestionsMode(): PoolQuestionsMode {\n  return process.env.POOL_QUESTIONS_MODE?.trim() === \"on\" ? \"on\" : \"off\";\n}\n\n/** Push delivery mode for high-VoI pool questions (IND-421). */\nexport type PoolQuestionsPushMode = \"off\" | \"on\";\n\n/**\n * Current POOL_QUESTIONS_PUSH mode (default off). Callers must additionally\n * require pool-question mode and negotiator availability before delivery.\n */\nexport function poolQuestionsPushMode(): PoolQuestionsPushMode {\n  return process.env.POOL_QUESTIONS_PUSH?.trim() === \"on\" ? \"on\" : \"off\";\n}\n\n/** Newborn-opportunity stamping mode (IND-420 P4b). */\nexport type PoolQuestionsStampNewbornMode = \"off\" | \"on\";\n\n/**\n * Current POOL_QUESTIONS_STAMP_NEWBORN mode (default off). Effective callers\n * additionally require {@link poolQuestionsMode} to be on.\n */\nexport function poolQuestionsStampNewborn(): PoolQuestionsStampNewbornMode {\n  return process.env.POOL_QUESTIONS_STAMP_NEWBORN?.trim() === \"on\" ? \"on\" : \"off\";\n}\n\n/** Minimum VoI for a discriminator to become (or chain) a question. */\nexport const POOL_QUESTION_MIN_VOI = 0.2;\n\n/** Minimum evidence-verification rate for a discriminator to become a question. */\nexport const POOL_QUESTION_MIN_EVIDENCE_RATE = 0.6;\n\n/** Max eligible discriminators carried per mining pass (asked + alternates). */\nexport const POOL_QUESTION_MAX_DISCRIMINATORS = 3;\n\n/** Unattended budget: max pending questions of ANY mode per intent. */\nexport const POOL_QUESTION_MAX_PENDING_PER_INTENT = 3;\n\n/** Initial internal VoI threshold for proactive push delivery. */\nexport const POOL_QUESTION_PUSH_BASE_VOI = 0.6;\n\n/** Multiplicative VoI threshold increase per consecutive dismissal. */\nexport const POOL_QUESTION_PUSH_DISMISSAL_DECAY = 1.15;\n\n/** Minimum pool size for proactive delivery (stricter than mining). */\nexport const POOL_QUESTION_PUSH_MIN_POOL_SIZE = 8;\n\n/** Maximum claimed proactive pool pushes per recipient per UTC day. */\nexport const POOL_QUESTION_PUSH_DAILY_CAP = 2;\n\n/** Ranking mode for pool adjustments (IND-419). */\nexport type PoolQuestionsRankingMode = \"off\" | \"on\";\n\n/**\n * Current POOL_QUESTIONS_RANKING (default off). When \"on\", the home feed\n * orders by adjusted confidence (confidence × Π poolAdjustments.factor,\n * floor {@link POOL_ADJUSTMENT_FLOOR}). Adjustments are WRITTEN regardless of\n * this flag — it only gates whether ordering reads them, so the apply path\n * can ship first.\n */\nexport function poolQuestionsRanking(): PoolQuestionsRankingMode {\n  return process.env.POOL_QUESTIONS_RANKING?.trim() === \"on\" ? \"on\" : \"off\";\n}\n\n/** Adjustment factor for candidates on the side the user did NOT choose. */\nexport const POOL_ADJUSTMENT_FACTOR_OTHER = 0.6;\n\n/** Adjustment factor for candidates the miner could not assign (unknown). */\nexport const POOL_ADJUSTMENT_FACTOR_UNKNOWN = 0.9;\n\n/** Floor for the cumulative adjustment multiplier — demoted, never hidden. */\nexport const POOL_ADJUSTMENT_FLOOR = 0.3;\n\n/**\n * Staleness guard (IND-419): when more than this fraction of a question's\n * stored assignments point at opportunities that left the pool (expired /\n * rejected / accepted / archived), skip the re-rank — the snapshot no longer\n * describes the live pool.\n */\nexport const POOL_STALENESS_THRESHOLD = 0.3;\n\n/** Debounce window for answer-triggered re-discovery (Tier 1), per intent. */\nexport const POOL_RERUN_DEBOUNCE_MS = 60_000;\n\n/**\n * k-anonymity floor: axes are only mined when the pool has at least this many\n * candidates, so no axis (or later, question option) can be traced back to a\n * specific individual.\n */\nexport const POOL_DISCRIMINATOR_MIN_POOL_SIZE = 5;\n\n/** Max candidates sent to the miner LLM (top-N by score). */\nexport const POOL_DISCRIMINATOR_MAX_CANDIDATES = 24;\n\n/** Max chars of public context per candidate in the miner prompt. */\nexport const POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS = 400;\n"]}

package/dist/opportunity/discriminator/discriminator.push.d.ts

@@ -0,0 +1,16 @@
+import type { QuestionPoolSnapshot } from "../../shared/schemas/question.schema.js";
+/** Maximum raw intent-title characters included in a proactive DM line. */
+export declare const POOL_QUESTION_PUSH_TITLE_MAX_CHARS = 80;
+/** Stable identity for one pool refresh cycle. Chained alternates retain it. */
+export declare function poolQuestionCycleKey(pool: Pick<QuestionPoolSnapshot, "runId" | "minedAt">): string;
+/** Strict VoI threshold after the recipient's consecutive dismissal streak. */
+export declare function poolQuestionPushThreshold(consecutiveDismissals: number): number;
+/** Escape plain text so it cannot alter the deterministic Markdown template. */
+export declare function escapePoolPushMarkdown(text: string): string;
+/** Build the sole proactive user-facing DM line for a pushed pool question. */
+export declare function buildPoolQuestionPushMessage(input: {
+    intentId: string;
+    intentTitle: string;
+    questionPrompt: string;
+}): string;
+//# sourceMappingURL=discriminator.push.d.ts.map

package/dist/opportunity/discriminator/discriminator.push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminator.push.d.ts","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.push.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAIpF,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC,GACpD,MAAM,CAGR;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAMT"}

package/dist/opportunity/discriminator/discriminator.push.js

@@ -0,0 +1,26 @@
+import { POOL_QUESTION_PUSH_BASE_VOI, POOL_QUESTION_PUSH_DISMISSAL_DECAY } from "./discriminator.env.js";
+/** Maximum raw intent-title characters included in a proactive DM line. */
+export const POOL_QUESTION_PUSH_TITLE_MAX_CHARS = 80;
+/** Stable identity for one pool refresh cycle. Chained alternates retain it. */
+export function poolQuestionCycleKey(pool) {
+    const runId = pool.runId?.trim();
+    return runId ? `run:${runId}` : `mined:${pool.minedAt}`;
+}
+/** Strict VoI threshold after the recipient's consecutive dismissal streak. */
+export function poolQuestionPushThreshold(consecutiveDismissals) {
+    const streak = Math.max(0, Math.floor(consecutiveDismissals));
+    return POOL_QUESTION_PUSH_BASE_VOI * POOL_QUESTION_PUSH_DISMISSAL_DECAY ** streak;
+}
+/** Escape plain text so it cannot alter the deterministic Markdown template. */
+export function escapePoolPushMarkdown(text) {
+    return text.replace(/([\\`*_[\]{}()<>#+\-.!|])/g, "\\$1");
+}
+/** Build the sole proactive user-facing DM line for a pushed pool question. */
+export function buildPoolQuestionPushMessage(input) {
+    const normalizedTitle = input.intentTitle.replace(/\s+/g, " ").trim() || "your intent";
+    const boundedTitle = normalizedTitle.length > POOL_QUESTION_PUSH_TITLE_MAX_CHARS
+        ? `${normalizedTitle.slice(0, POOL_QUESTION_PUSH_TITLE_MAX_CHARS - 1)}…`
+        : normalizedTitle;
+    return `Quick one about [${escapePoolPushMarkdown(boundedTitle)}](/i/${input.intentId}): ${escapePoolPushMarkdown(input.questionPrompt)}`;
+}
+//# sourceMappingURL=discriminator.push.js.map

package/dist/opportunity/discriminator/discriminator.push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminator.push.js","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.push.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAEzG,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,CAAC;AAErD,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAClC,IAAqD;IAErD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CAAC,qBAA6B;IACrE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC9D,OAAO,2BAA2B,GAAG,kCAAkC,IAAI,MAAM,CAAC;AACpF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,4BAA4B,CAAC,KAI5C;IACC,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,aAAa,CAAC;IACvF,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,GAAG,kCAAkC;QAC9E,CAAC,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,kCAAkC,GAAG,CAAC,CAAC,GAAG;QACxE,CAAC,CAAC,eAAe,CAAC;IACpB,OAAO,oBAAoB,sBAAsB,CAAC,YAAY,CAAC,QAAQ,KAAK,CAAC,QAAQ,MAAM,sBAAsB,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;AAC5I,CAAC","sourcesContent":["import type { QuestionPoolSnapshot } from \"../../shared/schemas/question.schema.js\";\n\nimport { POOL_QUESTION_PUSH_BASE_VOI, POOL_QUESTION_PUSH_DISMISSAL_DECAY } from \"./discriminator.env.js\";\n\n/** Maximum raw intent-title characters included in a proactive DM line. */\nexport const POOL_QUESTION_PUSH_TITLE_MAX_CHARS = 80;\n\n/** Stable identity for one pool refresh cycle. Chained alternates retain it. */\nexport function poolQuestionCycleKey(\n  pool: Pick<QuestionPoolSnapshot, \"runId\" | \"minedAt\">,\n): string {\n  const runId = pool.runId?.trim();\n  return runId ? `run:${runId}` : `mined:${pool.minedAt}`;\n}\n\n/** Strict VoI threshold after the recipient's consecutive dismissal streak. */\nexport function poolQuestionPushThreshold(consecutiveDismissals: number): number {\n  const streak = Math.max(0, Math.floor(consecutiveDismissals));\n  return POOL_QUESTION_PUSH_BASE_VOI * POOL_QUESTION_PUSH_DISMISSAL_DECAY ** streak;\n}\n\n/** Escape plain text so it cannot alter the deterministic Markdown template. */\nexport function escapePoolPushMarkdown(text: string): string {\n  return text.replace(/([\\\\`*_[\\]{}()<>#+\\-.!|])/g, \"\\\\$1\");\n}\n\n/** Build the sole proactive user-facing DM line for a pushed pool question. */\nexport function buildPoolQuestionPushMessage(input: {\n  intentId: string;\n  intentTitle: string;\n  questionPrompt: string;\n}): string {\n  const normalizedTitle = input.intentTitle.replace(/\\s+/g, \" \").trim() || \"your intent\";\n  const boundedTitle = normalizedTitle.length > POOL_QUESTION_PUSH_TITLE_MAX_CHARS\n    ? `${normalizedTitle.slice(0, POOL_QUESTION_PUSH_TITLE_MAX_CHARS - 1)}…`\n    : normalizedTitle;\n  return `Quick one about [${escapePoolPushMarkdown(boundedTitle)}](/i/${input.intentId}): ${escapePoolPushMarkdown(input.questionPrompt)}`;\n}\n"]}

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

@@ -471,7 +471,55 @@ export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
     intentText?: string | undefined;
     intentFingerprint?: string | undefined;
 }>;
-export declare const QuestionDetectionSchema: z.ZodObject<{
+/** Internal delivery ledger for proactive pool-question pushes (IND-421). */
+export declare const QuestionPoolPushSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    source: z.ZodLiteral<"pool_discovery">;
+    recipientId: z.ZodString;
+    intentId: z.ZodString;
+    cycleKey: z.ZodString;
+    messageId: z.ZodString;
+    surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodLiteral<"negotiator_dm">], null>;
+    claimedAt: z.ZodString;
+    deliveryStatus: z.ZodEnum<["claimed", "delivered", "suppressed", "failed"]>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    deliveredAt: z.ZodOptional<z.ZodString>;
+    suppressedAt: z.ZodOptional<z.ZodString>;
+    failure: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: "pool_discovery";
+    version: 1;
+    recipientId: string;
+    intentId: string;
+    cycleKey: string;
+    messageId: string;
+    surfaces: ["personal_agent_badge", "negotiator_dm"];
+    claimedAt: string;
+    deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+    conversationId?: string | undefined;
+    deliveredAt?: string | undefined;
+    suppressedAt?: string | undefined;
+    failure?: string | undefined;
+}, {
+    source: "pool_discovery";
+    version: 1;
+    recipientId: string;
+    intentId: string;
+    cycleKey: string;
+    messageId: string;
+    surfaces: ["personal_agent_badge", "negotiator_dm"];
+    claimedAt: string;
+    deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+    conversationId?: string | undefined;
+    deliveredAt?: string | undefined;
+    suppressedAt?: string | undefined;
+    failure?: string | undefined;
+}>;
+/** Durable request state for proactive pool-question delivery. */
+export declare const QuestionPoolPushRequestStatusSchema: z.ZodEnum<["requested", "suppressed"]>;
+/** 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. */
@@ -675,16 +723,87 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
         intentText?: string | undefined;
         intentFingerprint?: string | 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. */
+    pushRecoveryAttemptedAt: z.ZodOptional<z.ZodString>;
+    /** Durable request outcome. Internal only. */
+    pushRequestStatus: z.ZodOptional<z.ZodEnum<["requested", "suppressed"]>>;
+    /** Permanent suppression reason for an unclaimed request. Internal only. */
+    pushRequestReason: z.ZodOptional<z.ZodEnum<["question_lifecycle", "intent_lifecycle", "malformed_source", "malformed_actor", "malformed_pool", "malformed_cycle", "visited", "pool_size", "voi", "cycle_budget"]>>;
+    /** ISO-8601 timestamp at which an unclaimed request was suppressed. Internal only. */
+    pushRequestSuppressedAt: z.ZodOptional<z.ZodString>;
+    /** Internal proactive delivery state. Never serialize to public clients. */
+    push: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        source: z.ZodLiteral<"pool_discovery">;
+        recipientId: z.ZodString;
+        intentId: z.ZodString;
+        cycleKey: z.ZodString;
+        messageId: z.ZodString;
+        surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodLiteral<"negotiator_dm">], null>;
+        claimedAt: z.ZodString;
+        deliveryStatus: z.ZodEnum<["claimed", "delivered", "suppressed", "failed"]>;
+        conversationId: z.ZodOptional<z.ZodString>;
+        deliveredAt: z.ZodOptional<z.ZodString>;
+        suppressedAt: z.ZodOptional<z.ZodString>;
+        failure: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "pool_discovery";
+        version: 1;
+        recipientId: string;
+        intentId: string;
+        cycleKey: string;
+        messageId: string;
+        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        claimedAt: string;
+        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+        conversationId?: string | undefined;
+        deliveredAt?: string | undefined;
+        suppressedAt?: string | undefined;
+        failure?: string | undefined;
+    }, {
+        source: "pool_discovery";
+        version: 1;
+        recipientId: string;
+        intentId: string;
+        cycleKey: string;
+        messageId: string;
+        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        claimedAt: string;
+        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+        conversationId?: string | undefined;
+        deliveredAt?: string | undefined;
+        suppressedAt?: string | undefined;
+        failure?: string | undefined;
+    }>>;
+    /** Authoritative successful-delivery ledger timestamp. Internal only. */
+    pushedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     mode: "intent" | "chat" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
     sourceType: string;
     sourceId: string;
     timestamp: string;
+    push?: {
+        source: "pool_discovery";
+        version: 1;
+        recipientId: string;
+        intentId: string;
+        cycleKey: string;
+        messageId: string;
+        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        claimedAt: string;
+        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+        conversationId?: string | undefined;
+        deliveredAt?: string | undefined;
+        suppressedAt?: string | undefined;
+        failure?: string | undefined;
+    } | 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;
+    messageId?: string | undefined;
     purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
-    messageId?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -720,16 +839,169 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
         intentText?: string | undefined;
         intentFingerprint?: string | undefined;
     } | undefined;
+    pushRequestedAt?: string | undefined;
+    pushRecoveryAttemptedAt?: string | undefined;
+    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;
+    pushedAt?: string | undefined;
 }, {
     mode: "intent" | "chat" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
     sourceType: string;
     sourceId: string;
     timestamp: string;
+    push?: {
+        source: "pool_discovery";
+        version: 1;
+        recipientId: string;
+        intentId: string;
+        cycleKey: string;
+        messageId: string;
+        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        claimedAt: string;
+        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+        conversationId?: string | undefined;
+        deliveredAt?: string | undefined;
+        suppressedAt?: string | undefined;
+        failure?: string | undefined;
+    } | 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;
+    messageId?: string | undefined;
     purpose?: "uptake" | undefined;
     triggeredBy?: string | undefined;
+    pool?: {
+        poolSize: number;
+        minedAt: string;
+        discriminator: {
+            label: string;
+            questionSeed: string;
+            sides: string[];
+            sideCounts: Record<string, number>;
+            voi: number;
+            evidenceRate: number;
+            assignments: {
+                opportunityId: string;
+                side: string;
+            }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
+        };
+        alternates: {
+            label: string;
+            questionSeed: string;
+            sides: string[];
+            sideCounts: Record<string, number>;
+            voi: number;
+            evidenceRate: number;
+            assignments: {
+                opportunityId: string;
+                side: string;
+            }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
+        }[];
+        runId?: string | undefined;
+        intentText?: string | undefined;
+        intentFingerprint?: string | undefined;
+    } | undefined;
+    pushRequestedAt?: string | undefined;
+    pushRecoveryAttemptedAt?: string | undefined;
+    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;
+    pushedAt?: string | undefined;
+}>, {
+    mode: "intent" | "chat" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
+    sourceType: string;
+    sourceId: string;
+    timestamp: string;
+    push?: {
+        source: "pool_discovery";
+        version: 1;
+        recipientId: string;
+        intentId: string;
+        cycleKey: string;
+        messageId: string;
+        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        claimedAt: string;
+        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+        conversationId?: string | undefined;
+        deliveredAt?: string | undefined;
+        suppressedAt?: string | undefined;
+        failure?: string | undefined;
+    } | 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;
+    messageId?: string | undefined;
+    purpose?: "uptake" | undefined;
+    triggeredBy?: string | undefined;
+    pool?: {
+        poolSize: number;
+        minedAt: string;
+        discriminator: {
+            label: string;
+            questionSeed: string;
+            sides: string[];
+            sideCounts: Record<string, number>;
+            voi: number;
+            evidenceRate: number;
+            assignments: {
+                opportunityId: string;
+                side: string;
+            }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
+        };
+        alternates: {
+            label: string;
+            questionSeed: string;
+            sides: string[];
+            sideCounts: Record<string, number>;
+            voi: number;
+            evidenceRate: number;
+            assignments: {
+                opportunityId: string;
+                side: string;
+            }[];
+            embedding?: number[] | undefined;
+            embeddingModel?: string | undefined;
+        }[];
+        runId?: string | undefined;
+        intentText?: string | undefined;
+        intentFingerprint?: string | undefined;
+    } | undefined;
+    pushRequestedAt?: string | undefined;
+    pushRecoveryAttemptedAt?: string | undefined;
+    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;
+    pushedAt?: string | undefined;
+}, {
+    mode: "intent" | "chat" | "enrichment" | "discovery" | "negotiation" | "negotiation_inflight" | "pool_discovery";
+    sourceType: string;
+    sourceId: string;
+    timestamp: string;
+    push?: {
+        source: "pool_discovery";
+        version: 1;
+        recipientId: string;
+        intentId: string;
+        cycleKey: string;
+        messageId: string;
+        surfaces: ["personal_agent_badge", "negotiator_dm"];
+        claimedAt: string;
+        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
+        conversationId?: string | undefined;
+        deliveredAt?: string | undefined;
+        suppressedAt?: string | undefined;
+        failure?: string | undefined;
+    } | 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;
     messageId?: string | undefined;
+    purpose?: "uptake" | undefined;
+    triggeredBy?: string | undefined;
     pool?: {
         poolSize: number;
         minedAt: string;
@@ -765,6 +1037,12 @@ export declare const QuestionDetectionSchema: z.ZodObject<{
         intentText?: string | undefined;
         intentFingerprint?: string | undefined;
     } | undefined;
+    pushRequestedAt?: string | undefined;
+    pushRecoveryAttemptedAt?: string | undefined;
+    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;
+    pushedAt?: string | undefined;
 }>;
 export declare const QuestionActorSchema: z.ZodObject<{
     /** The user this question is for. */
@@ -810,4 +1088,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 QuestionPoolPush = z.infer<typeof QuestionPoolPushSchema>;
+export type QuestionPoolPushRequestStatus = z.infer<typeof QuestionPoolPushRequestStatusSchema>;
+export type QuestionPoolPushRequestReason = z.infer<typeof QuestionPoolPushRequestReasonSchema>;
 //# sourceMappingURL=question.schema.d.ts.map

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

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

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

@@ -111,6 +111,40 @@ export const QuestionPoolSnapshotSchema = z.object({
     /** Remaining ranked discriminators for interview-mode chaining. */
     alternates: z.array(QuestionPoolDiscriminatorSchema),
 });
+/** Internal delivery ledger for proactive pool-question pushes (IND-421). */
+export const QuestionPoolPushSchema = z.object({
+    version: z.literal(1),
+    source: z.literal("pool_discovery"),
+    recipientId: z.string().min(1),
+    intentId: z.string().min(1),
+    cycleKey: z.string().min(1),
+    messageId: z.string().min(1),
+    surfaces: z.tuple([
+        z.literal("personal_agent_badge"),
+        z.literal("negotiator_dm"),
+    ]),
+    claimedAt: z.string().min(1),
+    deliveryStatus: z.enum(["claimed", "delivered", "suppressed", "failed"]),
+    conversationId: z.string().min(1).optional(),
+    deliveredAt: z.string().min(1).optional(),
+    suppressedAt: z.string().min(1).optional(),
+    failure: z.string().min(1).max(500).optional(),
+});
+/** Durable request state for proactive pool-question delivery. */
+export const QuestionPoolPushRequestStatusSchema = z.enum(["requested", "suppressed"]);
+/** Permanent reasons that terminalize an unclaimed proactive push request. */
+export const QuestionPoolPushRequestReasonSchema = z.enum([
+    "question_lifecycle",
+    "intent_lifecycle",
+    "malformed_source",
+    "malformed_actor",
+    "malformed_pool",
+    "malformed_cycle",
+    "visited",
+    "pool_size",
+    "voi",
+    "cycle_budget",
+]);
 export const QuestionDetectionSchema = z.object({
     /** Which preset mode generated this question. */
     mode: QuestionModeSchema,
@@ -135,6 +169,59 @@ export const QuestionDetectionSchema = z.object({
      * INTERNAL — stripped from every client-facing read (web + MCP).
      */
     pool: QuestionPoolSnapshotSchema.optional(),
+    /** Durable request marker written before enqueueing proactive delivery. Internal only. */
+    pushRequestedAt: z.string().min(1).optional(),
+    /** Last bounded recovery sweep that selected this request. Internal only. */
+    pushRecoveryAttemptedAt: z.string().min(1).optional(),
+    /** Durable request outcome. Internal only. */
+    pushRequestStatus: QuestionPoolPushRequestStatusSchema.optional(),
+    /** Permanent suppression reason for an unclaimed request. Internal only. */
+    pushRequestReason: QuestionPoolPushRequestReasonSchema.optional(),
+    /** ISO-8601 timestamp at which an unclaimed request was suppressed. Internal only. */
+    pushRequestSuppressedAt: z.string().min(1).optional(),
+    /** Internal proactive delivery state. Never serialize to public clients. */
+    push: QuestionPoolPushSchema.optional(),
+    /** Authoritative successful-delivery ledger timestamp. Internal only. */
+    pushedAt: z.string().min(1).optional(),
+}).superRefine((detection, ctx) => {
+    if (detection.mode === "pool_discovery"
+        && (!detection.triggeredBy?.trim() || detection.triggeredBy !== detection.sourceId)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["triggeredBy"],
+            message: "pool_discovery triggeredBy must be non-empty and equal sourceId",
+        });
+    }
+    if (detection.pushRequestStatus && !detection.pushRequestedAt) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["pushRequestedAt"],
+            message: "push request state requires a request timestamp",
+        });
+    }
+    if (detection.pushRecoveryAttemptedAt && !detection.pushRequestedAt) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["pushRequestedAt"],
+            message: "push recovery attempts require a request timestamp",
+        });
+    }
+    if (detection.pushRequestStatus === "suppressed") {
+        if (!detection.pushRequestReason) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["pushRequestReason"],
+                message: "suppressed push requests require a reason",
+            });
+        }
+        if (!detection.pushRequestSuppressedAt) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["pushRequestSuppressedAt"],
+                message: "suppressed push requests require a timestamp",
+            });
+        }
+    }
 });
 export const QuestionActorSchema = z.object({
     /** The user this question is for. */