@indexnetwork/protocol 20.0.0-rc.484.1 → 20.0.1-rc.485.1

package/CHANGELOG.md

@@ -20,6 +20,30 @@ 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`.
 
+## 20.0.1 - 2026-08-17
+
+### Changed
+
+- Flatten `src/questions/` from four directories to one, matching the same move
+  already made in `intents/` and `networks/`, and the flat layout of `chat/`,
+  `discovery/`, and `premises/`. The `domain/`, `ports/`, and `application/`
+  directories held two,
+  two, and six files behind 206 lines of re-export barrel; the three sub-barrels
+  re-exported roughly twenty symbols no consumer outside the capability ever
+  imported. Files now sit flat and are named for what they are
+  (`question.schema`, `question.input`, `question.agent`, `question.presets`,
+  `question.env`, `question.tools`, `question.ask.tool`, and the two ports), with
+  a single `index.ts` as the capability barrel.
+- Fold the QUD taxonomy constant into `question.presets.ts`, its only consumer,
+  retiring the 16-line `question.qud.ts`.
+- Share the negotiation candidate/provenance field shape and their identical
+  counterparty-eligibility refinement instead of declaring both twice. The two
+  `superRefine` blocks stated the same uptake-only rule in different words; they
+  now delegate to one helper, so the invariant has a single definition.
+
+The package's exported surface is unchanged — `questions/index.ts` exports the
+same 44 names as before. Only paths private to the capability moved.
+
 ## 20.0.0 - 2026-08-17
 
 ### Changed

package/dist/mcp/elicitation.builder.d.ts

@@ -1,4 +1,4 @@
-import type { Question } from "../questions/domain/question.schema.js";
+import type { Question } from "../questions/question.schema.js";
 type SingleChoiceSchema = {
     type: "string";
     enum: string[];

package/dist/mcp/elicitation.dispatcher.d.ts

@@ -1,4 +1,4 @@
-import type { Question } from "../questions/domain/question.schema.js";
+import type { Question } from "../questions/question.schema.js";
 import type { ChatMessageWriter } from "../shared/interfaces/chat-message-writer.interface.js";
 import { buildElicitationCreate } from "./elicitation.builder.js";
 export type ElicitResultLike = {

package/dist/questions/index.d.ts

@@ -2,12 +2,41 @@
  * questions — the capability's sole cross-capability surface.
  *
  * Anything outside this capability imports from here and nowhere else.
- * Supersedes the capabilities/*.facade.ts + questions/public/ pair; the export
- * list is the union of the facades it replaces, so the contract is unchanged.
+ *
+ * ## What lives in the capability
+ *
+ * - **question.schema** — Zod schemas and derived types for the whole question
+ *   vocabulary: the public Question shape, generator envelopes, and the
+ *   detection/provenance/pool/recovery persistence sub-schemas.
+ * - **question.input** — per-mode context types, the discriminated
+ *   QuestionerInput union, and `isValidQuestionerInputContract`, the runtime
+ *   mirror of that discriminant enforced at queue boundaries.
+ * - **question.agent** — QuestionerAgent: stateless, mode-driven generation.
+ * - **question.presets** — system prompts and user-message builders per mode.
+ * - **question.env** — the QUESTIONER_* env accessors. All reads go through it.
+ * - **question.tools** / **question.ask.tool** — foreground adapters: the
+ *   authenticated MCP read/answer tools, and the blocking chat
+ *   `ask_user_question` tool.
+ * - **question.persistence.port** / **question.tools.port** — the injected
+ *   host contracts (question CRUD, chat host bridge, tool host capabilities).
+ *
+ * Ambient generation (recovery, pool, uptake, inflight, push) is scheduled via
+ * the backend QuestionerQueue, which consumes the {@link QuestionerEnqueueFn}
+ * injected from the composition root.
+ *
+ * ## Boundary
+ *
+ * The capability imports from shared/ infrastructure and the negotiations
+ * barrel — never from runtime/, host implementations, or other capability
+ * internals.
  */
-export type { QuestionerEnqueueFn, } from "./application/question.input.js";
-export { createAskUserQuestionTools, createQuestionerTools, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, intentQuestionDailyCap, isQuestionerEnabled, isUptakeGuardEnabled, isValidQuestionerInputContract, QuestionerAgent, uptakeAuthorityThreshold, } from "./application/index.js";
-export type { InflightQuestionerInput, PoolDiscoveryContext, PostStallQuestionerInput, QuestionerEnqueuePayload, QuestionerInput, RecoveryQuestionerInput, UptakeQuestionerInput, } from "./application/index.js";
-export type { AskUserQuestionToolDeps, ChatQuestionsHost, PersistableQuestion, PersistedQuestion, QuestionerDatabase, QuestionerToolDeps, QuestionFilters, } from "./ports/index.js";
-export { NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, UnderspecificationTypeSchema, } from "./domain/index.js";
-export type { NegotiationQuestionCandidate, QuestionOption, NegotiationQuestionProvenance, NegotiationQuestionPurpose, Question, QuestionGenerationResult, QuestionPoolDiscriminator, QuestionPoolPush, QuestionPoolPushRequestReason, QuestionPoolPushRequestStatus, QuestionPoolSnapshot, QuestionPurpose, QuestionRecoverySnapshot, QuestionStrategy, QuestionVoidedReason, UnderspecificationType, } from "./domain/index.js";
+export { QuestionerAgent } from "./question.agent.js";
+export { createAskUserQuestionTools } from "./question.ask.tool.js";
+export { createQuestionerTools } from "./question.tools.js";
+export { INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, intentQuestionDailyCap, isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, } from "./question.env.js";
+export { isValidQuestionerInputContract } from "./question.input.js";
+export type { InflightQuestionerInput, PoolDiscoveryContext, PostStallQuestionerInput, QuestionerEnqueueFn, QuestionerEnqueuePayload, QuestionerInput, RecoveryQuestionerInput, UptakeQuestionerInput, } from "./question.input.js";
+export type { ChatQuestionsHost, PersistableQuestion, PersistedQuestion, QuestionerDatabase, QuestionFilters, } from "./question.persistence.port.js";
+export type { AskUserQuestionToolDeps, QuestionerToolDeps } from "./question.tools.port.js";
+export { NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, UnderspecificationTypeSchema, } from "./question.schema.js";
+export type { NegotiationQuestionCandidate, NegotiationQuestionProvenance, NegotiationQuestionPurpose, Question, QuestionGenerationResult, QuestionOption, QuestionPoolDiscriminator, QuestionPoolPush, QuestionPoolPushRequestReason, QuestionPoolPushRequestStatus, QuestionPoolSnapshot, QuestionPurpose, QuestionRecoverySnapshot, QuestionStrategy, QuestionVoidedReason, UnderspecificationType, } from "./question.schema.js";

package/dist/questions/index.js

@@ -1,2 +1,38 @@
-export { createAskUserQuestionTools, createQuestionerTools, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, intentQuestionDailyCap, isQuestionerEnabled, isUptakeGuardEnabled, isValidQuestionerInputContract, QuestionerAgent, uptakeAuthorityThreshold, } from "./application/index.js";
-export { NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, UnderspecificationTypeSchema, } from "./domain/index.js";
+/**
+ * questions — the capability's sole cross-capability surface.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ *
+ * ## What lives in the capability
+ *
+ * - **question.schema** — Zod schemas and derived types for the whole question
+ *   vocabulary: the public Question shape, generator envelopes, and the
+ *   detection/provenance/pool/recovery persistence sub-schemas.
+ * - **question.input** — per-mode context types, the discriminated
+ *   QuestionerInput union, and `isValidQuestionerInputContract`, the runtime
+ *   mirror of that discriminant enforced at queue boundaries.
+ * - **question.agent** — QuestionerAgent: stateless, mode-driven generation.
+ * - **question.presets** — system prompts and user-message builders per mode.
+ * - **question.env** — the QUESTIONER_* env accessors. All reads go through it.
+ * - **question.tools** / **question.ask.tool** — foreground adapters: the
+ *   authenticated MCP read/answer tools, and the blocking chat
+ *   `ask_user_question` tool.
+ * - **question.persistence.port** / **question.tools.port** — the injected
+ *   host contracts (question CRUD, chat host bridge, tool host capabilities).
+ *
+ * Ambient generation (recovery, pool, uptake, inflight, push) is scheduled via
+ * the backend QuestionerQueue, which consumes the {@link QuestionerEnqueueFn}
+ * injected from the composition root.
+ *
+ * ## Boundary
+ *
+ * The capability imports from shared/ infrastructure and the negotiations
+ * barrel — never from runtime/, host implementations, or other capability
+ * internals.
+ */
+export { QuestionerAgent } from "./question.agent.js";
+export { createAskUserQuestionTools } from "./question.ask.tool.js";
+export { createQuestionerTools } from "./question.tools.js";
+export { INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, intentQuestionDailyCap, isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, } from "./question.env.js";
+export { isValidQuestionerInputContract } from "./question.input.js";
+export { NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, UnderspecificationTypeSchema, } from "./question.schema.js";

package/dist/questions/{application/question.agent.d.ts → question.agent.d.ts}

@@ -1,5 +1,5 @@
-import { type QuestionGenerationResult } from "../domain/question.schema.js";
-import { createStructuredModel } from "../../shared/agent/model.config.js";
+import { type QuestionGenerationResult } from "./question.schema.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
 import { type QuestionerInput } from "./question.input.js";
 export interface QuestionerAgentConfig {
     /** Optional model config override. */

package/dist/questions/{application/question.agent.js → question.agent.js}

@@ -8,7 +8,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 /**
- * questions/application/question.agent — QuestionerAgent.
+ * questions/question.agent — QuestionerAgent.
  *
  * Stateless, mode-driven agent that generates structured decision questions
  * from arbitrary protocol contexts.
@@ -17,16 +17,13 @@ var __metadata = (this && this.__metadata) || function (k, v) {
  * single public `invoke()` method receives the full context per call.
  * The LLM model is bound once at construction; the preset (system prompt +
  * builder) is selected per invocation based on `input.mode`.
- *
- * IND-547: canonical home — previously questioner/questioner.agent.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
-import { QuestionGeneratorResponseSchema } from "../domain/question.schema.js";
-import { createStructuredModel } from "../../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { Timed } from "../../shared/observability/performance.js";
+import { QuestionGeneratorResponseSchema } from "./question.schema.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { Timed } from "../shared/observability/performance.js";
 import { getPreset } from "./question.presets.js";
 import { isValidQuestionerInputContract } from "./question.input.js";
 const logger = protocolLogger("QuestionerAgent");

package/dist/questions/{application/question.ask.tool.d.ts → question.ask.tool.d.ts}

@@ -1,5 +1,5 @@
-import type { DefineTool } from "../../shared/agent/tool.helpers.js";
-import type { AskUserQuestionToolDeps } from "../ports/question.tools.port.js";
+import type { DefineTool } from "../shared/agent/tool.helpers.js";
+import type { AskUserQuestionToolDeps } from "./question.tools.port.js";
 import { QuestionerAgent } from "./question.agent.js";
 /** Test seam: replace or reset the module-level QuestionerAgent singleton. */
 export declare function setQuestionerAgentForTesting(agent: QuestionerAgent | null): void;

package/dist/questions/{application/question.ask.tool.js → question.ask.tool.js}

@@ -1,5 +1,5 @@
 /**
- * questions/application/question.ask.tool — foreground adapter: chat ask_user_question tool.
+ * questions/question.ask.tool — foreground adapter: chat ask_user_question tool.
  *
  * Blocking mid-conversation questions for the chat orchestrator
  * (AskUserQuestion-style human-in-the-loop).
@@ -26,14 +26,11 @@
  * Foreground adapter: registered by `createChatTools` only when
  * `deps.chatQuestions` is provided — never part of the MCP tool registry
  * (MCP clients have their own elicitation surface).
- *
- * IND-547: canonical home — previously questioner/questioner.ask.tool.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
 import { z } from "zod";
-import { error, success } from "../../shared/agent/tool.helpers.js";
-import { requestContext } from "../../shared/observability/request-context.js";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
+import { error, success } from "../shared/agent/tool.helpers.js";
+import { requestContext } from "../shared/observability/request-context.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { QuestionerAgent } from "./question.agent.js";
 import { chatQuestionWaitTimeoutMs } from "./question.env.js";
 const logger = protocolLogger("AskUserQuestionTool");

package/dist/questions/{application/question.env.d.ts → question.env.d.ts}

@@ -1,5 +1,5 @@
 /**
- * questions/application/question.env — centralized question-generation env accessors.
+ * questions/question.env — centralized question-generation env accessors.
  *
  * Naming scheme (one prefix, hierarchical):
  *
@@ -18,9 +18,6 @@
  * 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
  * and long-lived processes observe changes.
- *
- * IND-547: canonical home — previously questioner/questioner.env.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
 export declare const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
 export declare const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;

package/dist/questions/{application/question.env.js → question.env.js}

@@ -1,5 +1,5 @@
 /**
- * questions/application/question.env — centralized question-generation env accessors.
+ * questions/question.env — centralized question-generation env accessors.
  *
  * Naming scheme (one prefix, hierarchical):
  *
@@ -18,9 +18,6 @@
  * 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
  * and long-lived processes observe changes.
- *
- * IND-547: canonical home — previously questioner/questioner.env.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
 export const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
 export const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;

package/dist/questions/{application/question.input.d.ts → question.input.d.ts}

@@ -1,5 +1,5 @@
 /**
- * questions/application/question.input — QuestionerAgent input envelope.
+ * questions/question.input — QuestionerAgent input envelope.
  *
  * Defines per-mode context types (IntentContext, NegotiationContext, …),
  * the discriminated QuestionerInput union, and the runtime validation guard
@@ -13,13 +13,10 @@
  * Foreground and ambient adapter entry points inject a `QuestionerEnqueueFn`
  * (defined here as a port alias) to schedule async generation without
  * importing the queue implementation.
- *
- * IND-547: canonical home — previously questioner/questioner.types.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
-import type { ToolScopeType } from "../../shared/agent/tool.scope.js";
-import type { NegotiationQuestionCandidate, QuestionMode, QuestionPoolDiscriminator } from "../domain/question.schema.js";
-import type { NegotiationConsultationReason } from "../../negotiations/index.js";
+import type { ToolScopeType } from "../shared/agent/tool.scope.js";
+import type { NegotiationQuestionCandidate, QuestionMode, QuestionPoolDiscriminator } from "./question.schema.js";
+import type { NegotiationConsultationReason } from "../negotiations/index.js";
 /** Intent context — data needed to generate questions about an intent. */
 export interface IntentContext {
     intentId: string;

package/dist/questions/{application/question.input.js → question.input.js}

@@ -1,4 +1,4 @@
-import { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, NEGOTIATION_QUESTION_GENERIC_UPTAKE_ACTIVITY } from "../../negotiations/index.js";
+import { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, NEGOTIATION_QUESTION_GENERIC_UPTAKE_ACTIVITY } from "../negotiations/index.js";
 /** Runtime mirror of the mode/purpose/context discriminant used at queue boundaries. */
 export function isValidQuestionerInputContract(input) {
     if (input.purpose === 'recovery') {

package/dist/questions/{ports/question.persistence.port.d.ts → question.persistence.port.d.ts}

@@ -1,13 +1,11 @@
 /**
- * questions/ports/question.persistence.port — question persistence contracts.
+ * questions/question.persistence.port — question persistence contracts.
  *
  * Protocol-level persistence contract for structured questions generated by
  * QuestionerAgent. Implementations live in the backend and are injected into
  * ProtocolDeps.
- *
- * IND-547: canonical question persistence port.
  */
-import type { Question, QuestionMode, QuestionPurpose, QuestionStrategy, QuestionDetection, QuestionActor, QuestionAnswer, UnderspecificationType } from "../domain/question.schema.js";
+import type { Question, QuestionMode, QuestionPurpose, QuestionStrategy, QuestionDetection, QuestionActor, QuestionAnswer, UnderspecificationType } from "./question.schema.js";
 /** Shape accepted by `persist()` — everything needed to insert a question row. */
 export interface PersistableQuestion {
     detection: QuestionDetection;

package/dist/questions/{application/question.presets.d.ts → question.presets.d.ts}

@@ -1,13 +1,10 @@
 /**
- * questions/application/question.presets — mode presets for QuestionerAgent.
+ * questions/question.presets — mode presets for QuestionerAgent.
  *
  * Each preset provides a system prompt and a buildPrompt function that assembles
  * the user message from a typed context object.
- *
- * IND-547: canonical home — previously questioner/questioner.presets.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
-import type { QuestionMode, QuestionPurpose } from "../domain/question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "./question.schema.js";
 export interface QuestionerPreset {
     /** The LLM system prompt for this mode. */
     systemPrompt: string;

package/dist/questions/{application/question.presets.js → question.presets.js}

@@ -1,5 +1,15 @@
-import { QUD_UNDERSPECIFICATION_RULES } from "./question.qud.js";
-import { consultationPromptFor } from "../../negotiations/index.js";
+import { consultationPromptFor } from "../negotiations/index.js";
+/**
+ * Questions Under Discussion taxonomy, appended to every preset's system prompt.
+ * Every mode carries it because the structured output schema requires the
+ * internal `underspecificationType` field; intent and discovery are the primary
+ * consumers of non-null classifications.
+ */
+const QUD_UNDERSPECIFICATION_RULES = `QUD underspecification taxonomy. For every structured question, emit a required \`underspecificationType\` field. Use exactly one category only when the question repairs that kind of underspecification:
+- missing_constituent: an absent core participant, entity, or outcome (who/what).
+- missing_constraint: the core target exists, but a ranking boundary is missing (where/when/how/how much).
+- open_alternative_set: an unresolved choice among materially different interpretations or scopes.
+Use null for adjacent, reflective, emergent, or any other question that does not repair underspecification. Strategy and underspecification type are orthogonal: \`strategy\` describes the conversational move; \`underspecificationType\` describes the QUD defect repaired. Never infer one mechanically from the other.`;
 /**
  * Shared rule block appended to every questioner system prompt. Enforces that
  * the generated `prompt` resolves on its own — no demonstratives/anaphora that

package/dist/questions/{domain/question.schema.d.ts → question.schema.d.ts}

@@ -1,14 +1,12 @@
 /**
- * questions/domain/question.schema — canonical home for question value types and schemas.
+ * questions/question.schema — canonical home for question value types and schemas.
  *
  * Defines the public structured shape consumed by frontend renderers and MCP
  * elicitation dispatch, plus internal generator, persistence, and delivery
  * envelopes used across the questions capability.
- *
- * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
-import { UnderspecificationTypeSchema, type UnderspecificationType } from "../../shared/schemas/underspecification.schema.js";
+import { UnderspecificationTypeSchema, type UnderspecificationType } from "../shared/schemas/underspecification.schema.js";
 export { UnderspecificationTypeSchema };
 export declare const QuestionOptionSchema: z.ZodObject<{
     /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
@@ -256,24 +254,24 @@ export declare const QuestionPurposeSchema: z.ZodEnum<["uptake", "recovery", "st
  * 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;
+    readonly purpose: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
+    readonly recipientUserId: z.ZodString;
+    readonly recipientIntentId: z.ZodString;
+    readonly opportunityId: z.ZodString;
+    readonly taskId: z.ZodOptional<z.ZodString>;
+    readonly 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>;
+    readonly counterpartyUserId: z.ZodOptional<z.ZodString>;
+    readonly counterpartyIntentId: z.ZodOptional<z.ZodString>;
+    readonly 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;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }, {
@@ -282,8 +280,8 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
     recipientUserId: string;
     recipientIntentId: string;
     opportunityId: string;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }>, {
@@ -292,8 +290,8 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
     recipientUserId: string;
     recipientIntentId: string;
     opportunityId: string;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }, {
@@ -302,8 +300,8 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
     recipientUserId: string;
     recipientIntentId: string;
     opportunityId: string;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }>;
@@ -312,24 +310,23 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
  * questions. This object is stripped from every REST/MCP projection.
  */
 export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObject<{
-    version: z.ZodLiteral<1>;
+    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>;
+    /** Stable per-generation position so retries dedupe without reducing cardinality. */
+    questionOrdinal: z.ZodNumber;
     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;
+    version: z.ZodLiteral<1>;
 }, "strip", z.ZodTypeAny, {
     networkId: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
@@ -341,8 +338,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
     taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -358,8 +355,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
     taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -375,8 +372,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
     taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -392,8 +389,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
     taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -740,24 +737,23 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     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>;
+        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>;
+        /** Stable per-generation position so retries dedupe without reducing cardinality. */
+        questionOrdinal: z.ZodNumber;
         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;
+        version: z.ZodLiteral<1>;
     }, "strip", z.ZodTypeAny, {
         networkId: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
@@ -769,8 +765,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -786,8 +782,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -803,8 +799,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -820,8 +816,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -1161,8 +1157,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -1255,8 +1251,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -1349,8 +1345,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
@@ -1443,8 +1439,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
+        taskId?: string | undefined;
         counterpartyIntentId?: string | undefined;
         counterpartyFelicityAuthority?: number | undefined;
         taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;

package/dist/questions/{domain/question.schema.js → question.schema.js}

@@ -1,14 +1,12 @@
 /**
- * questions/domain/question.schema — canonical home for question value types and schemas.
+ * questions/question.schema — canonical home for question value types and schemas.
  *
  * Defines the public structured shape consumed by frontend renderers and MCP
  * elicitation dispatch, plus internal generator, persistence, and delivery
  * envelopes used across the questions capability.
- *
- * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
-import { UnderspecificationTypeSchema } from "../../shared/schemas/underspecification.schema.js";
+import { UnderspecificationTypeSchema } from "../shared/schemas/underspecification.schema.js";
 export { UnderspecificationTypeSchema };
 export const QuestionOptionSchema = z.object({
     /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
@@ -71,10 +69,11 @@ export const QuestionPurposeSchema = z.enum([
     "inflight_consultation",
 ]);
 /**
- * Producer-supplied candidate binding. The API re-resolves every field from
- * authoritative rows before generation; callers cannot mint provenance.
+ * Routing fields every negotiation-family binding carries. The provenance
+ * envelope extends this with freshness and ordinal fields; the candidate is
+ * exactly this shape.
  */
-export const NegotiationQuestionCandidateSchema = z.object({
+const negotiationQuestionBinding = {
     purpose: NegotiationQuestionPurposeSchema,
     recipientUserId: z.string().min(1),
     recipientIntentId: z.string().min(1),
@@ -85,7 +84,29 @@ export const NegotiationQuestionCandidateSchema = z.object({
     counterpartyUserId: z.string().min(1).optional(),
     counterpartyIntentId: z.string().min(1).optional(),
     counterpartyFelicityAuthority: z.number().min(0).max(100).optional(),
-}).superRefine((candidate, ctx) => {
+};
+/**
+ * Counterparty eligibility is carried by uptake bindings and ONLY by uptake
+ * bindings — exactly present on uptake, entirely absent otherwise. Identical on
+ * the candidate and the provenance envelope, so both delegate here.
+ */
+function refineCounterpartyEligibility(binding, ctx) {
+    const path = ["counterpartyUserId"];
+    if (binding.purpose === "uptake") {
+        if (!binding.counterpartyUserId || !binding.counterpartyIntentId || binding.counterpartyFelicityAuthority === undefined) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, path, message: "uptake bindings require exact counterparty eligibility" });
+        }
+        return;
+    }
+    if (binding.counterpartyUserId || binding.counterpartyIntentId || binding.counterpartyFelicityAuthority !== undefined) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path, message: "only uptake bindings carry counterparty eligibility" });
+    }
+}
+/**
+ * Producer-supplied candidate binding. The API re-resolves every field from
+ * authoritative rows before generation; callers cannot mint provenance.
+ */
+export const NegotiationQuestionCandidateSchema = z.object(negotiationQuestionBinding).superRefine((candidate, ctx) => {
     const taskRequired = candidate.purpose !== "uptake";
     if (taskRequired !== Boolean(candidate.taskId)) {
         ctx.addIssue({
@@ -96,13 +117,7 @@ export const NegotiationQuestionCandidateSchema = z.object({
                 : "uptake questions must not carry a synthetic taskId",
         });
     }
-    const hasCounterparty = Boolean(candidate.counterpartyUserId) || Boolean(candidate.counterpartyIntentId);
-    if (candidate.purpose === "uptake" && (!candidate.counterpartyUserId || !candidate.counterpartyIntentId || candidate.counterpartyFelicityAuthority === undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "uptake questions require exact counterparty provenance" });
-    }
-    if (candidate.purpose !== "uptake" && (hasCounterparty || candidate.counterpartyFelicityAuthority !== undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "only uptake questions carry counterparty provenance" });
-    }
+    refineCounterpartyEligibility(candidate, ctx);
 });
 /**
  * Durable server-only routing and freshness envelope for negotiation-family
@@ -110,21 +125,12 @@ export const NegotiationQuestionCandidateSchema = z.object({
  */
 export const NegotiationQuestionProvenanceSchema = z.object({
     version: z.literal(1),
-    purpose: NegotiationQuestionPurposeSchema,
-    recipientUserId: z.string().min(1),
-    recipientIntentId: z.string().min(1),
-    opportunityId: z.string().min(1),
-    taskId: z.string().min(1).optional(),
-    networkId: z.string().min(1),
+    ...negotiationQuestionBinding,
     intentFingerprint: z.string().min(1),
     opportunityStatus: z.enum(["latent", "draft", "negotiating", "pending", "stalled", "accepted", "rejected", "expired"]),
     opportunityUpdatedAt: z.string().datetime(),
     taskState: z.enum(["submitted", "working", "input_required", "completed", "canceled", "failed", "rejected", "auth_required", "waiting_for_agent", "claimed"]).optional(),
     taskUpdatedAt: z.string().datetime().optional(),
-    /** Uptake only: exact low-authority counterparty eligibility binding. */
-    counterpartyUserId: z.string().min(1).optional(),
-    counterpartyIntentId: z.string().min(1).optional(),
-    counterpartyFelicityAuthority: z.number().min(0).max(100).optional(),
     /** Stable per-generation position so retries dedupe without reducing cardinality. */
     questionOrdinal: z.number().int().min(0).max(2),
 }).superRefine((provenance, ctx) => {
@@ -149,13 +155,7 @@ export const NegotiationQuestionProvenanceSchema = z.object({
     if (provenance.purpose === "inflight_consultation" && provenance.taskState !== "input_required") {
         ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["taskState"], message: "inflight task must be input_required" });
     }
-    const hasCounterparty = Boolean(provenance.counterpartyUserId) || Boolean(provenance.counterpartyIntentId);
-    if (provenance.purpose === "uptake" && (!provenance.counterpartyUserId || !provenance.counterpartyIntentId || provenance.counterpartyFelicityAuthority === undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "uptake provenance requires exact counterparty eligibility" });
-    }
-    if (provenance.purpose !== "uptake" && (hasCounterparty || provenance.counterpartyFelicityAuthority !== undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "only uptake provenance carries counterparty eligibility" });
-    }
+    refineCounterpartyEligibility(provenance, ctx);
 });
 export const QuestionModeSchema = z.enum([
     "intent",

package/dist/questions/{application/question.tools.d.ts → question.tools.d.ts}

@@ -1,5 +1,5 @@
-import type { DefineTool } from "../../shared/agent/tool.helpers.js";
-import type { QuestionerToolDeps } from "../ports/question.tools.port.js";
+import type { DefineTool } from "../shared/agent/tool.helpers.js";
+import type { QuestionerToolDeps } from "./question.tools.port.js";
 /**
  * Creates MCP tool definitions for the questioner domain.
  *

package/dist/questions/{application/question.tools.js → question.tools.js}

@@ -1,5 +1,5 @@
 /**
- * questions/application/question.tools — foreground adapter: MCP question tools.
+ * questions/question.tools — foreground adapter: MCP question tools.
  *
  * Creates MCP tool definitions for the questions domain. Exposes
  * `read_pending_questions` and `answer_pending_question` for retrieving and
@@ -9,14 +9,11 @@
  * Foreground adapter: these tools respond to authenticated user actions
  * (read, answer, dismiss). Ambient delivery adapters are handled separately
  * via the QuestionerQueue.
- *
- * IND-547: canonical home — previously questioner/questioner.tools.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
 import { z } from "zod";
-import { error, success } from "../../shared/agent/tool.helpers.js";
-import { focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../../shared/agent/tool.scope.js";
-import { callerMayAccessQuestionMode } from "../../shared/agent/activity-projection.js";
+import { error, success } from "../shared/agent/tool.helpers.js";
+import { focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../shared/agent/tool.scope.js";
+import { callerMayAccessQuestionMode } from "../shared/agent/activity-projection.js";
 /**
  * Detection modes whose questions derive solely from the caller's own data
  * (profile gaps, own intents, own discovery sessions). Negotiation-mode

package/dist/questions/{ports/question.tools.port.d.ts → question.tools.port.d.ts}

@@ -1,13 +1,11 @@
 /**
- * questions/ports/question.tools.port — host capabilities injected into question tools.
+ * questions/question.tools.port — host capabilities injected into question tools.
  *
  * Declares the narrow port types consumed by the foreground adapter tools
  * (question delivery and chat-inline ask_user_question) without importing
  * the full ToolRegistryCompositionDeps interface.
- *
- * IND-547: canonical tool-host port.
  */
-import type { ToolRegistryCompositionDeps } from "../../shared/agent/tool.helpers.js";
+import type { ToolRegistryCompositionDeps } from "../shared/agent/tool.helpers.js";
 /** Host capabilities consumed by asynchronous question delivery tools. */
 export type QuestionerToolDeps = Pick<ToolRegistryCompositionDeps, "answerPendingQuestion" | "findPendingQuestions" | "reportToolError">;
 /** Host capabilities consumed by the blocking, chat-only question tool. */

package/dist/shared/agent/tool.helpers.d.ts

@@ -20,11 +20,11 @@ import type { AgentDatabase } from "../../agents/ports/index.js";
 import type { NegotiationTimeoutQueue } from "../interfaces/negotiation-events.interface.js";
 import type { AgentDispatcher } from "../interfaces/agent-dispatcher.interface.js";
 import type { DeliveryLedger } from "../interfaces/delivery-ledger.interface.js";
-import type { ChatQuestionsHost, QuestionerDatabase } from "../../questions/ports/index.js";
+import type { ChatQuestionsHost, QuestionerDatabase } from "../../questions/question.persistence.port.js";
 import type { NegotiatorMemoryToolsHost } from "../interfaces/negotiator-memory.interface.js";
-import type { QuestionerEnqueueFn } from "../../questions/application/question.input.js";
+import type { QuestionerEnqueueFn } from "../../questions/question.input.js";
 import type { PendingQuestionSummary } from "../schemas/pending-question.schema.js";
-import type { QuestionMode, QuestionPurpose } from "../../questions/domain/question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "../../questions/question.schema.js";
 import type { EnrichmentRunQueue, EnrichmentRunStore } from "../interfaces/enrichment-run.interface.js";
 import type { McpActivityCaller } from "./activity-projection.js";
 export type IdentityContext = UserIdentity | null;

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

@@ -3,7 +3,7 @@
  * in tool results. Omits internal fields (actors, answer, status) that
  * are not needed by the chat agent or MCP client.
  */
-import type { QuestionMode, QuestionPurpose } from "../../questions/domain/question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "../../questions/question.schema.js";
 export interface PendingQuestionSummary {
     id: string;
     title: string;

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

@@ -5,7 +5,7 @@ import { z } from "zod";
  * Shared between signals (the intent clarifier decides whether an utterance is
  * underspecified) and questions (which records the category on the question it
  * raises). It lives here rather than inside either capability because both need
- * it: filing it under `questions/domain` meant the signals clarifier had to
+ * it: filing it under `questions/` meant the signals clarifier had to
  * import the whole questions capability — LLM agents and tools included — to
  * reach a three-value enum.
  */

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

@@ -5,7 +5,7 @@ import { z } from "zod";
  * Shared between signals (the intent clarifier decides whether an utterance is
  * underspecified) and questions (which records the category on the question it
  * raises). It lives here rather than inside either capability because both need
- * it: filing it under `questions/domain` meant the signals clarifier had to
+ * it: filing it under `questions/` meant the signals clarifier had to
  * import the whole questions capability — LLM agents and tools included — to
  * reach a three-value enum.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "20.0.0-rc.484.1",
+  "version": "20.0.1-rc.485.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

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

@@ -1,39 +0,0 @@
-/**
- * questions/application — orchestrators, agents, env, tools, and presets.
- *
- * Re-exports the orchestration tier of the questions capability: the
- * QuestionerAgent, env accessors, generation presets, and adapter tool
- * factories.
- *
- * ## Foreground adapters (participant-directed, authenticated)
- *
- * - {@link createQuestionerTools} — `read_pending_questions` and
- *   `answer_pending_question` MCP tools for authenticated answer/dismiss paths.
- * - {@link createAskUserQuestionTools} — blocking chat `ask_user_question`
- *   tool for inline chat orchestrator questions.
- *
- * ## Ambient adapters (background generation)
- *
- * Recovery, pool, uptake, inflight, and push generation are scheduled via
- * the QuestionerQueue (backend). They consume {@link QuestionerEnqueueFn}
- * injected from the composition root and call QuestionerAgent.invoke() with
- * the appropriate mode context. The ports for these adapters are declared in
- * `questions/ports/question.persistence.port.ts`.
- *
- * ## Boundary
- *
- * Imports from questions/domain, questions/ports, shared/ infrastructure,
- * and narrow capability facades (negotiation.questions.facade) — never from
- * runtime/, host implementations, or other capability internals.
- *
- * IND-547: canonical application layer for the questions capability.
- */
-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, 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";
-export { createAskUserQuestionTools, setQuestionerAgentForTesting } from "./question.ask.tool.js";

package/dist/questions/application/index.js

@@ -1,41 +0,0 @@
-/**
- * questions/application — orchestrators, agents, env, tools, and presets.
- *
- * Re-exports the orchestration tier of the questions capability: the
- * QuestionerAgent, env accessors, generation presets, and adapter tool
- * factories.
- *
- * ## Foreground adapters (participant-directed, authenticated)
- *
- * - {@link createQuestionerTools} — `read_pending_questions` and
- *   `answer_pending_question` MCP tools for authenticated answer/dismiss paths.
- * - {@link createAskUserQuestionTools} — blocking chat `ask_user_question`
- *   tool for inline chat orchestrator questions.
- *
- * ## Ambient adapters (background generation)
- *
- * Recovery, pool, uptake, inflight, and push generation are scheduled via
- * the QuestionerQueue (backend). They consume {@link QuestionerEnqueueFn}
- * injected from the composition root and call QuestionerAgent.invoke() with
- * the appropriate mode context. The ports for these adapters are declared in
- * `questions/ports/question.persistence.port.ts`.
- *
- * ## Boundary
- *
- * Imports from questions/domain, questions/ports, shared/ infrastructure,
- * and narrow capability facades (negotiation.questions.facade) — never from
- * runtime/, host implementations, or other capability internals.
- *
- * IND-547: canonical application layer for the questions capability.
- */
-// ── Domain input types + validation ──────────────────────────────────────────
-export { isValidQuestionerInputContract, } from "./question.input.js";
-// ── Agent ─────────────────────────────────────────────────────────────────────
-export { QuestionerAgent } from "./question.agent.js";
-// ── Env ───────────────────────────────────────────────────────────────────────
-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 ──────────────────────────────────────────────────
-export { createQuestionerTools } from "./question.tools.js";
-export { createAskUserQuestionTools, setQuestionerAgentForTesting } from "./question.ask.tool.js";

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

@@ -1,12 +0,0 @@
-/**
- * questions/application/question.qud — Questions Under Discussion taxonomy.
- *
- * Shared QUD taxonomy contract for structured question-generation prompts.
- * Every Questioner mode uses this block because the structured output schema
- * requires the internal metadata field; intent and discovery are the primary
- * consumers of non-null classifications.
- *
- * IND-547: canonical home — previously questioner/questioner.qud.ts.
- * Legacy path is a thin compatibility shim pointing here.
- */
-export declare const QUD_UNDERSPECIFICATION_RULES = "QUD underspecification taxonomy. For every structured question, emit a required `underspecificationType` field. Use exactly one category only when the question repairs that kind of underspecification:\n- missing_constituent: an absent core participant, entity, or outcome (who/what).\n- missing_constraint: the core target exists, but a ranking boundary is missing (where/when/how/how much).\n- open_alternative_set: an unresolved choice among materially different interpretations or scopes.\nUse null for adjacent, reflective, emergent, or any other question that does not repair underspecification. Strategy and underspecification type are orthogonal: `strategy` describes the conversational move; `underspecificationType` describes the QUD defect repaired. Never infer one mechanically from the other.";

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

@@ -1,16 +0,0 @@
-/**
- * questions/application/question.qud — Questions Under Discussion taxonomy.
- *
- * Shared QUD taxonomy contract for structured question-generation prompts.
- * Every Questioner mode uses this block because the structured output schema
- * requires the internal metadata field; intent and discovery are the primary
- * consumers of non-null classifications.
- *
- * IND-547: canonical home — previously questioner/questioner.qud.ts.
- * Legacy path is a thin compatibility shim pointing here.
- */
-export const QUD_UNDERSPECIFICATION_RULES = `QUD underspecification taxonomy. For every structured question, emit a required \`underspecificationType\` field. Use exactly one category only when the question repairs that kind of underspecification:
-- missing_constituent: an absent core participant, entity, or outcome (who/what).
-- missing_constraint: the core target exists, but a ranking boundary is missing (where/when/how/how much).
-- open_alternative_set: an unresolved choice among materially different interpretations or scopes.
-Use null for adjacent, reflective, emergent, or any other question that does not repair underspecification. Strategy and underspecification type are orthogonal: \`strategy\` describes the conversational move; \`underspecificationType\` describes the QUD defect repaired. Never infer one mechanically from the other.`;

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

@@ -1,24 +0,0 @@
-/**
- * questions/domain — pure question value types and schemas.
- *
- * Contains Zod schemas and TypeScript types that define the questions
- * capability's domain language.  No LLM calls, no agents, no cross-capability
- * imports beyond zod.
- *
- * ## What lives here
- *
- * - **question.schema** — Question, QuestionWithStrategy, QuestionDetection,
- *   QuestionMode, QuestionPurpose, NegotiationQuestionCandidate,
- *   NegotiationQuestionProvenance, pool/push/recovery sub-schemas, and all
- *   derived TypeScript types.
- *
- * ## What does NOT live here
- *
- * - QuestionerInput/QuestionerContext: they reference capability facades
- *   (negotiation question-safety) and belong in questions/application.
- * - QuestionerAgent and tool factories: application layer.
- * - Persistence/generator ports: questions/ports.
- *
- * IND-547: canonical home for question domain types.
- */
-export * from "./question.schema.js";

package/dist/questions/domain/index.js

@@ -1,24 +0,0 @@
-/**
- * questions/domain — pure question value types and schemas.
- *
- * Contains Zod schemas and TypeScript types that define the questions
- * capability's domain language.  No LLM calls, no agents, no cross-capability
- * imports beyond zod.
- *
- * ## What lives here
- *
- * - **question.schema** — Question, QuestionWithStrategy, QuestionDetection,
- *   QuestionMode, QuestionPurpose, NegotiationQuestionCandidate,
- *   NegotiationQuestionProvenance, pool/push/recovery sub-schemas, and all
- *   derived TypeScript types.
- *
- * ## What does NOT live here
- *
- * - QuestionerInput/QuestionerContext: they reference capability facades
- *   (negotiation question-safety) and belong in questions/application.
- * - QuestionerAgent and tool factories: application layer.
- * - Persistence/generator ports: questions/ports.
- *
- * IND-547: canonical home for question domain types.
- */
-export * from "./question.schema.js";

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

@@ -1,27 +0,0 @@
-/**
- * questions/ports — injected dependency contracts for the questions capability.
- *
- * Re-exports the narrow port types that the questions module declares as explicit
- * injected boundaries. Consumers import these to wire host implementations
- * without depending on the application layer.
- *
- * ## Port groups
- *
- * ### Persistence ports
- * - QuestionerDatabase — question CRUD (persist, findPending, answer, dismiss).
- * - PersistableQuestion, PersistedQuestion, QuestionFilters — persistence shapes.
- *
- * ### Chat host port
- * - ChatQuestionsHost — blocking inline ask_user_question host bridge.
- * - ChatQuestionAnswerOutcome — resolution shape for awaited answers.
- *
- * ### Generator port (deprecated)
- *
- * ### Tool host ports
- * - QuestionerToolDeps — host capabilities for async question delivery tools.
- * - AskUserQuestionToolDeps — host capabilities for the chat ask_user_question tool.
- *
- * IND-547: canonical ports surface for the questions capability.
- */
-export type { PersistableQuestion, PersistedQuestion, QuestionFilters, ChatQuestionAnswerOutcome, ChatQuestionsHost, QuestionerDatabase, } from "./question.persistence.port.js";
-export type { QuestionerToolDeps, AskUserQuestionToolDeps } from "./question.tools.port.js";

package/dist/questions/ports/index.js

@@ -1,26 +0,0 @@
-/**
- * questions/ports — injected dependency contracts for the questions capability.
- *
- * Re-exports the narrow port types that the questions module declares as explicit
- * injected boundaries. Consumers import these to wire host implementations
- * without depending on the application layer.
- *
- * ## Port groups
- *
- * ### Persistence ports
- * - QuestionerDatabase — question CRUD (persist, findPending, answer, dismiss).
- * - PersistableQuestion, PersistedQuestion, QuestionFilters — persistence shapes.
- *
- * ### Chat host port
- * - ChatQuestionsHost — blocking inline ask_user_question host bridge.
- * - ChatQuestionAnswerOutcome — resolution shape for awaited answers.
- *
- * ### Generator port (deprecated)
- *
- * ### Tool host ports
- * - QuestionerToolDeps — host capabilities for async question delivery tools.
- * - AskUserQuestionToolDeps — host capabilities for the chat ask_user_question tool.
- *
- * IND-547: canonical ports surface for the questions capability.
- */
-export {};