@indexnetwork/protocol 14.0.0-rc.468.1 → 14.1.0-rc.469.1

package/CHANGELOG.md

@@ -20,6 +20,20 @@ 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`.
 
+## 14.1.0 - 2026-08-16
+
+### Added
+
+- `intentQuestionDailyCap()` env accessor plus the `INTENT_QUESTION_DAILY_CAP_DEFAULT`
+  (2) and `INTENT_QUESTION_DAILY_WINDOW_HOURS` (24) constants, exported from the
+  questions capability. These express a per-intent budget for background
+  refinement questions over a rolling 24 hours, spanning the recovery and
+  pool-discovery families combined.
+
+  Zero is a meaningful setting — it disables background refinement without
+  touching `QUESTIONER_ENABLED` — so the accessor deliberately does not reuse
+  `positiveIntEnv`. Configured by `QUESTIONER_INTENT_DAILY_CAP`.
+
 ## 13.2.1 - 2026-08-16
 
 No public API change: all 441 exported symbols are byte-identical to 13.2.0, and

package/dist/capabilities/questions.facade.d.ts

@@ -4,5 +4,5 @@
  * IND-547: updated to re-export from questions/public/index.js.
  * Legacy consumers importing from this path continue to work unchanged.
  */
-export { QuestionerAgent, isValidQuestionerInputContract, isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, createQuestionerTools, createAskUserQuestionTools, NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, } from "../questions/public/index.js";
+export { QuestionerAgent, isValidQuestionerInputContract, isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, intentQuestionDailyCap, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, createQuestionerTools, createAskUserQuestionTools, NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, } from "../questions/public/index.js";
 export type { QuestionerInput, RecoveryQuestionerInput, UptakeQuestionerInput, PostStallQuestionerInput, InflightQuestionerInput, QuestionerEnqueuePayload, QuestionerEnqueueFn, PoolDiscoveryContext, QuestionerToolDeps, AskUserQuestionToolDeps, ChatQuestionsHost, NegotiationQuestionCandidate, NegotiationQuestionProvenance, NegotiationQuestionPurpose, PersistableQuestion, PersistedQuestion, Question, QuestionFilters, QuestionGenerationResult, QuestionPoolDiscriminator, QuestionPoolPush, QuestionPoolPushRequestReason, QuestionPoolPushRequestStatus, QuestionPoolSnapshot, QuestionPurpose, QuestionRecoverySnapshot, QuestionStrategy, QuestionVoidedReason, QuestionerDatabase, UnderspecificationType, } from "../questions/public/index.js";

package/dist/capabilities/questions.facade.js

@@ -4,4 +4,4 @@
  * IND-547: updated to re-export from questions/public/index.js.
  * Legacy consumers importing from this path continue to work unchanged.
  */
-export { QuestionerAgent, isValidQuestionerInputContract, isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, createQuestionerTools, createAskUserQuestionTools, NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, } from "../questions/public/index.js";
+export { QuestionerAgent, isValidQuestionerInputContract, isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, intentQuestionDailyCap, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, createQuestionerTools, createAskUserQuestionTools, NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, } from "../questions/public/index.js";

package/dist/index.d.ts

@@ -82,7 +82,7 @@ export type { NegotiatorMemoryEntry } from "./capabilities/negotiation.facade.js
 export { QuestionerAgent } from "./capabilities/questions.facade.js";
 export { isValidQuestionerInputContract } from "./capabilities/questions.facade.js";
 export type { QuestionerInput, RecoveryQuestionerInput, UptakeQuestionerInput, PostStallQuestionerInput, InflightQuestionerInput, QuestionerEnqueuePayload, QuestionerEnqueueFn, PoolDiscoveryContext } from "./capabilities/questions.facade.js";
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold } from "./capabilities/questions.facade.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, intentQuestionDailyCap, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS } from "./capabilities/questions.facade.js";
 export { PoolDiscriminatorMiner } from "./capabilities/opportunities.facade.js";
 export { PoolDiscriminatorAssigner } from "./capabilities/opportunities.facade.js";
 export type { PoolDiscriminatorAssignmentInput, PoolDiscriminatorAssignedAxis } from "./capabilities/opportunities.facade.js";

package/dist/index.js

@@ -67,7 +67,7 @@ export { NegotiationScreener } from "./capabilities/negotiation.facade.js";
 export { NegotiationReflector } from "./capabilities/negotiation.facade.js";
 export { QuestionerAgent } from "./capabilities/questions.facade.js";
 export { isValidQuestionerInputContract } from "./capabilities/questions.facade.js";
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold } from "./capabilities/questions.facade.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, intentQuestionDailyCap, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS } from "./capabilities/questions.facade.js";
 export { PoolDiscriminatorMiner } from "./capabilities/opportunities.facade.js";
 export { PoolDiscriminatorAssigner } from "./capabilities/opportunities.facade.js";
 export { runPoolDiscriminatorShadow } from "./capabilities/opportunities.facade.js";

package/dist/questions/application/index.d.ts

@@ -32,7 +32,7 @@ export { isValidQuestionerInputContract, } from "./question.input.js";
 export type { QuestionerInput, QuestionerContext, QuestionerEnqueuePayload, QuestionerEnqueueFn, IntentContext, RecoveryIntentContext, NegotiationContext, PostStallNegotiationContext, UptakeNegotiationContext, NegotiationInflightContext, ChatContext, PoolDiscoveryContext, PostStallQuestionerInput, InflightQuestionerInput, UptakeQuestionerInput, RecoveryQuestionerInput, } from "./question.input.js";
 export { QuestionerAgent } from "./question.agent.js";
 export type { QuestionerAgentConfig } from "./question.agent.js";
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } from "./question.env.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, intentQuestionDailyCap, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "./question.env.js";
 export { getPreset } from "./question.presets.js";
 export type { QuestionerPreset } from "./question.presets.js";
 export { createQuestionerTools } from "./question.tools.js";

package/dist/questions/application/index.js

@@ -33,7 +33,7 @@ export { isValidQuestionerInputContract, } from "./question.input.js";
 // ── Agent ─────────────────────────────────────────────────────────────────────
 export { QuestionerAgent } from "./question.agent.js";
 // ── Env ───────────────────────────────────────────────────────────────────────
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } from "./question.env.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, intentQuestionDailyCap, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "./question.env.js";
 // ── Presets ───────────────────────────────────────────────────────────────────
 export { getPreset } from "./question.presets.js";
 // ── Foreground adapter tools ──────────────────────────────────────────────────

package/dist/questions/application/question.env.d.ts

@@ -11,6 +11,9 @@
  *                                       authority threshold (0-100, default 70).
  *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
  *                                       tool waits for an inline answer (default 4 min).
+ *   QUESTIONER_INTENT_DAILY_CAP         refinement questions one intent may generate
+ *                                       per rolling 24h, recovery + pool combined
+ *                                       (default 2; 0 disables refinement).
  *
  * All reads go through this module — do not read these variables via
  * `process.env` elsewhere. Values are read on every call (no caching) so tests
@@ -21,6 +24,25 @@
  */
 export declare const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
 export declare const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;
+/**
+ * Refinement questions a single intent may generate per rolling window.
+ *
+ * Recovery and pool mining both re-arm when the intent text changes, and
+ * answering a refinement question is itself what changes it — so each answer
+ * buys another question and the loop ends only when the user stops replying.
+ * Measured on a dev account: 27 questions against three intents in 9.5 hours,
+ * one discriminator asked three times, while the best-scoring match had already
+ * been found after the first question.
+ */
+export declare const INTENT_QUESTION_DAILY_CAP_DEFAULT = 2;
+/**
+ * Width of the budget window, in hours.
+ *
+ * Rolling rather than per-UTC-day deliberately: the observed bursts straddled
+ * midnight UTC (20:22-21:18, then 05:48-05:55), and a calendar-day budget would
+ * have granted the second burst a full fresh allowance.
+ */
+export declare const INTENT_QUESTION_DAILY_WINDOW_HOURS = 24;
 /** Master switch: is any background question generation enabled? */
 export declare function isQuestionerEnabled(): boolean;
 /** Advisory uptake interlock. Flag-off by default and subordinate to the master switch. */
@@ -29,3 +51,10 @@ export declare function isUptakeGuardEnabled(): boolean;
 export declare function uptakeAuthorityThreshold(): number;
 /** Wait budget for the blocking ask_user_question chat tool. */
 export declare function chatQuestionWaitTimeoutMs(): number;
+/**
+ * Per-intent refinement budget over {@link INTENT_QUESTION_DAILY_WINDOW_HOURS}.
+ *
+ * Zero is a meaningful setting — it disables background refinement entirely
+ * without touching the master switch — so this does not reuse `positiveIntEnv`.
+ */
+export declare function intentQuestionDailyCap(): number;

package/dist/questions/application/question.env.js

@@ -11,6 +11,9 @@
  *                                       authority threshold (0-100, default 70).
  *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
  *                                       tool waits for an inline answer (default 4 min).
+ *   QUESTIONER_INTENT_DAILY_CAP         refinement questions one intent may generate
+ *                                       per rolling 24h, recovery + pool combined
+ *                                       (default 2; 0 disables refinement).
  *
  * All reads go through this module — do not read these variables via
  * `process.env` elsewhere. Values are read on every call (no caching) so tests
@@ -21,6 +24,25 @@
  */
 export const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
 export const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;
+/**
+ * Refinement questions a single intent may generate per rolling window.
+ *
+ * Recovery and pool mining both re-arm when the intent text changes, and
+ * answering a refinement question is itself what changes it — so each answer
+ * buys another question and the loop ends only when the user stops replying.
+ * Measured on a dev account: 27 questions against three intents in 9.5 hours,
+ * one discriminator asked three times, while the best-scoring match had already
+ * been found after the first question.
+ */
+export const INTENT_QUESTION_DAILY_CAP_DEFAULT = 2;
+/**
+ * Width of the budget window, in hours.
+ *
+ * Rolling rather than per-UTC-day deliberately: the observed bursts straddled
+ * midnight UTC (20:22-21:18, then 05:48-05:55), and a calendar-day budget would
+ * have granted the second burst a full fresh allowance.
+ */
+export const INTENT_QUESTION_DAILY_WINDOW_HOURS = 24;
 /**
  * Parse a positive integer env var, clamped to the safe-integer range so a
  * malformed env value cannot crash `AbortSignal.timeout` (which throws on
@@ -57,3 +79,17 @@ export function uptakeAuthorityThreshold() {
 export function chatQuestionWaitTimeoutMs() {
     return positiveIntEnv("QUESTIONER_CHAT_WAIT_TIMEOUT_MS", CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT);
 }
+/**
+ * Per-intent refinement budget over {@link INTENT_QUESTION_DAILY_WINDOW_HOURS}.
+ *
+ * Zero is a meaningful setting — it disables background refinement entirely
+ * without touching the master switch — so this does not reuse `positiveIntEnv`.
+ */
+export function intentQuestionDailyCap() {
+    const raw = process.env.QUESTIONER_INTENT_DAILY_CAP;
+    if (!raw?.trim())
+        return INTENT_QUESTION_DAILY_CAP_DEFAULT;
+    if (!/^\d+$/.test(raw.trim()))
+        return INTENT_QUESTION_DAILY_CAP_DEFAULT;
+    return Number.parseInt(raw, 10);
+}

package/dist/questions/public/index.d.ts

@@ -40,7 +40,7 @@
 export * from "../domain/index.js";
 export { QuestionerAgent } from "../application/index.js";
 export type { QuestionerAgentConfig } from "../application/index.js";
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } from "../application/index.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, intentQuestionDailyCap, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "../application/index.js";
 export { isValidQuestionerInputContract, } from "../application/index.js";
 export type { QuestionerInput, QuestionerEnqueuePayload, QuestionerEnqueueFn, PoolDiscoveryContext, RecoveryQuestionerInput, UptakeQuestionerInput, PostStallQuestionerInput, InflightQuestionerInput, } from "../application/index.js";
 export { createQuestionerTools, createAskUserQuestionTools } from "../application/index.js";

package/dist/questions/public/index.js

@@ -42,7 +42,7 @@ export * from "../domain/index.js";
 // ── Application: agent ────────────────────────────────────────────────────────
 export { QuestionerAgent } from "../application/index.js";
 // ── Application: env accessors ────────────────────────────────────────────────
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } from "../application/index.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, intentQuestionDailyCap, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "../application/index.js";
 // ── Application: input types and validation ───────────────────────────────────
 export { isValidQuestionerInputContract, } from "../application/index.js";
 // ── Application: foreground adapter tools ─────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "14.0.0-rc.468.1",
+  "version": "14.1.0-rc.469.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",