@indexnetwork/protocol 20.0.0-rc.484.1 → 21.0.0-rc.486.1

package/CHANGELOG.md

@@ -20,6 +20,54 @@ 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`.
 
+## 21.0.0 - 2026-08-17
+
+### Removed
+
+- **Breaking:** remove the Agent reporter persona. `REPORTER_PERSONA`,
+  `REPORTER_PERSONA_ID`, `REPORTER_BRIEFING_KICKOFF`, `REPORTER_TOOL_NAMES`,
+  `createReporterTools`, `filterReporterTools` and `narrowReporterTools` are
+  gone from the package entry point, along with `reporter.persona.ts`,
+  `reporter.prompt.ts` and the `propose_cleanup_actions` tool
+  (`reporter.action.tools.ts`, `reporter.action.contracts.ts`). Hosts that named
+  the `reporter` persona must pick another; unknown personas already fail closed.
+- **Breaking:** drop `actionToolsEnabled` from `ToolContext`/`ToolDeps`/
+  `ResolvedToolContext` and `actionProposalStore` from `ToolDeps`. Both existed
+  solely to gate the reporter's cleanup-action tool. `resolveChatContext()` no
+  longer accepts or returns `actionToolsEnabled`.
+- Remove `ChatAgent.hasPriorAgentActionProposal()`, the
+  ```agent_action_proposal``` fence parser behind it, and
+  `IterationContext.hasPriorAgentActionProposal`. The reporter prompt was the
+  only consumer, so all of it became dead with the persona.
+
+`read_activity_summary` and the whole `activity-projection` module are
+**unchanged** — they are shared utility tools registered for every persona and
+exposed on the MCP server, not reporter-specific.
+
+## 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/IMPLEMENTATION.md

@@ -173,7 +173,7 @@ The intent and community graphs are the exceptions: they are reached through the
 
 ### Persisted chat personas
 
-`ChatGraphFactory.withPersona()` keeps the runtime neutral while selecting an exported persona configuration. `SIGNAL_PERSONA`, `REPORTER_PERSONA`, and `ONBOARDING_PERSONA` each own an exact positive tool allowlist; shared tools added later remain unavailable until reviewed. `ONBOARDING_PERSONA` reuses Signal's proposal-only, live-membership-narrowed `create_intent` contract and otherwise exposes only privacy consent, approved self-context preview/confirmation, guided questions, and validated completion. Hosts must persist the exported persona ID on session creation and treat it as authoritative on follow-ups.
+`ChatGraphFactory.withPersona()` keeps the runtime neutral while selecting an exported persona configuration. `SIGNAL_PERSONA` and `ONBOARDING_PERSONA` each own an exact positive tool allowlist; shared tools added later remain unavailable until reviewed. `ONBOARDING_PERSONA` reuses Signal's proposal-only, live-membership-narrowed `create_intent` contract and otherwise exposes only privacy consent, approved self-context preview/confirmation, guided questions, and validated completion. Hosts must persist the exported persona ID on session creation and treat it as authoritative on follow-ups.
 
 ## Intents
 

package/dist/agents/index.d.ts

@@ -15,7 +15,6 @@ export { ChatTitleGenerator, } from "../chat/chat.title.generator.js";
 export { createChatTools, } from "../chat/chat.tools.js";
 export { createNegotiatorPersona, NEGOTIATOR_PERSONA_ID, } from "../chat/negotiator.persona.js";
 export { createOnboardingTools, filterOnboardingTools, narrowOnboardingTools, ONBOARDING_PERSONA, ONBOARDING_PERSONA_ID, ONBOARDING_PROFILE_KICKOFF, ONBOARDING_TOOL_NAMES, } from "../chat/onboarding.persona.js";
-export { createReporterTools, filterReporterTools, narrowReporterTools, REPORTER_BRIEFING_KICKOFF, REPORTER_PERSONA, REPORTER_PERSONA_ID, REPORTER_TOOL_NAMES, } from "../chat/reporter.persona.js";
 export { createSignalTools, filterSignalTools, narrowSignalTools, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_PERSONA, SIGNAL_PERSONA_ID, SIGNAL_TOOL_NAMES, } from "../chat/signal.persona.js";
 export { createAgentTools, } from "./application/index.js";
 export { SYSTEM_AGENT_IDS, } from "./domain/index.js";

package/dist/agents/index.js

@@ -6,7 +6,6 @@ export { ChatTitleGenerator, } from "../chat/chat.title.generator.js";
 export { createChatTools, } from "../chat/chat.tools.js";
 export { createNegotiatorPersona, NEGOTIATOR_PERSONA_ID, } from "../chat/negotiator.persona.js";
 export { createOnboardingTools, filterOnboardingTools, narrowOnboardingTools, ONBOARDING_PERSONA, ONBOARDING_PERSONA_ID, ONBOARDING_PROFILE_KICKOFF, ONBOARDING_TOOL_NAMES, } from "../chat/onboarding.persona.js";
-export { createReporterTools, filterReporterTools, narrowReporterTools, REPORTER_BRIEFING_KICKOFF, REPORTER_PERSONA, REPORTER_PERSONA_ID, REPORTER_TOOL_NAMES, } from "../chat/reporter.persona.js";
 export { createSignalTools, filterSignalTools, narrowSignalTools, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_PERSONA, SIGNAL_PERSONA_ID, SIGNAL_TOOL_NAMES, } from "../chat/signal.persona.js";
 export { createAgentTools, } from "./application/index.js";
 export { SYSTEM_AGENT_IDS, } from "./domain/index.js";

package/dist/chat/chat.agent.d.ts

@@ -195,12 +195,6 @@ export declare class ChatAgent {
      * Extracts the text content of the most recent HumanMessage.
      */
     private static getCurrentUserMessage;
-    /**
-     * Detects a prior visible action proposal without considering current-turn
-     * tool calls. The reporter uses this only to make typed confirmation
-     * language contextual rather than executable on its own.
-     */
-    static hasPriorAgentActionProposal(messages: BaseMessage[]): boolean;
     /**
      * Async factory: creates a ChatAgent with resolved user/index context.
      * Resolves user/network identity from DB during tool initialization.

package/dist/chat/chat.agent.js

@@ -19,55 +19,6 @@ import { sanitizeForDebugMeta } from "../shared/observability/debug-meta.sanitiz
 import { Timed } from "../shared/observability/performance.js";
 import { requestContext } from "../shared/observability/request-context.js";
 import { deduplicateQuestions } from "./chat.question-dedup.js";
-const AGENT_ACTION_PROPOSAL_FENCE_PATTERN = /```agent_action_proposal\s*\n([\s\S]*?)\n```/g;
-const AGENT_ACTION_PROPOSAL_KEYS = new Set(["proposalId", "actions"]);
-const AGENT_ACTION_KEYS = new Set([
-    "type",
-    "entityId",
-    "currentState",
-    "proposedOperation",
-    "skipped",
-    "reason",
-    "description",
-    "evidence",
-]);
-const AGENT_ACTION_OPERATIONS = {
-    retract_premise: "RETRACT_PREMISE",
-    narrow_signal: "NARROW_SIGNAL",
-    pause_signal: "PAUSE_SIGNAL",
-};
-function isVisibleAgentActionProposal(payload) {
-    if (!payload || typeof payload !== "object" || Array.isArray(payload))
-        return false;
-    const proposal = payload;
-    if (Object.keys(proposal).some((key) => !AGENT_ACTION_PROPOSAL_KEYS.has(key)))
-        return false;
-    if (typeof proposal.proposalId !== "string"
-        || !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(proposal.proposalId)
-        || !Array.isArray(proposal.actions)
-        || proposal.actions.length < 1
-        || proposal.actions.length > 5)
-        return false;
-    return proposal.actions.every((rawAction) => {
-        if (!rawAction || typeof rawAction !== "object" || Array.isArray(rawAction))
-            return false;
-        const action = rawAction;
-        if (Object.keys(action).some((key) => !AGENT_ACTION_KEYS.has(key)))
-            return false;
-        if (typeof action.type !== "string" || !(action.type in AGENT_ACTION_OPERATIONS))
-            return false;
-        const type = action.type;
-        if (action.proposedOperation !== AGENT_ACTION_OPERATIONS[type])
-            return false;
-        if (typeof action.entityId !== "string" || !action.entityId.trim())
-            return false;
-        if (typeof action.currentState !== "string" || !action.currentState.trim())
-            return false;
-        if (action.skipped !== undefined && typeof action.skipped !== "boolean")
-            return false;
-        return ["reason", "description", "evidence"].every((key) => action[key] === undefined || typeof action[key] === "string");
-    });
-}
 const logger = protocolLogger("ChatAgent");
 // Re-export for external consumers
 export { ITERATION_NUDGE } from "./chat.prompt.js";
@@ -143,48 +94,6 @@ export class ChatAgent {
         }
         return undefined;
     }
-    /**
-     * Detects a prior visible action proposal without considering current-turn
-     * tool calls. The reporter uses this only to make typed confirmation
-     * language contextual rather than executable on its own.
-     */
-    static hasPriorAgentActionProposal(messages) {
-        let currentHumanIndex = -1;
-        let previousHumanIndex = -1;
-        for (let index = messages.length - 1; index >= 0; index -= 1) {
-            if (messages[index]._getType() !== "human")
-                continue;
-            if (currentHumanIndex < 0) {
-                currentHumanIndex = index;
-            }
-            else {
-                previousHumanIndex = index;
-                break;
-            }
-        }
-        if (currentHumanIndex < 0 || previousHumanIndex < 0)
-            return false;
-        let latestAssistant;
-        for (let index = currentHumanIndex - 1; index > previousHumanIndex; index -= 1) {
-            if (messages[index]._getType() === "ai") {
-                latestAssistant = messages[index];
-                break;
-            }
-        }
-        if (!latestAssistant || typeof latestAssistant.content !== "string")
-            return false;
-        AGENT_ACTION_PROPOSAL_FENCE_PATTERN.lastIndex = 0;
-        for (const match of latestAssistant.content.matchAll(AGENT_ACTION_PROPOSAL_FENCE_PATTERN)) {
-            try {
-                if (isVisibleAgentActionProposal(JSON.parse(match[1])))
-                    return true;
-            }
-            catch {
-                // An invalid prior fence is not visible proposal context.
-            }
-        }
-        return false;
-    }
     /**
      * Async factory: creates a ChatAgent with resolved user/index context.
      * Resolves user/network identity from DB during tool initialization.
@@ -204,7 +113,6 @@ export class ChatAgent {
             userId: context.userId,
             networkId: scopedNetworkId,
             sessionId: context.sessionId,
-            actionToolsEnabled: context.actionToolsEnabled,
         });
         if (explicitScope.scopeType && explicitScope.scopeId) {
             resolved.scopeType = explicitScope.scopeType;
@@ -224,7 +132,6 @@ export class ChatAgent {
         const iterCtx = {
             recentTools: extractRecentToolCalls(messages),
             currentMessage: ChatAgent.getCurrentUserMessage(messages),
-            hasPriorAgentActionProposal: ChatAgent.hasPriorAgentActionProposal(messages),
             ctx: this.resolvedContext,
         };
         const deterministicResponse = this.persona.resolveDeterministicResponse?.(this.resolvedContext, iterCtx);
@@ -583,7 +490,6 @@ export class ChatAgent {
             const iterCtx = {
                 recentTools: extractRecentToolCalls(messages),
                 currentMessage: ChatAgent.getCurrentUserMessage(messages),
-                hasPriorAgentActionProposal: ChatAgent.hasPriorAgentActionProposal(messages),
                 ctx: this.resolvedContext,
             };
             const deterministicResponse = this.persona.resolveDeterministicResponse?.(this.resolvedContext, iterCtx);

package/dist/chat/chat.persona.d.ts

@@ -9,8 +9,7 @@ export interface ChatPersonaLoopBehaviors {
      * Detect hallucinated ```opportunity / ```intent_proposal code blocks in model
      * text, auto-invoke the corresponding tool, and strip unbacked blocks from the
      * final response. Only meaningful for personas whose toolset can legitimately
-     * produce those blocks — enabled for onboarding, signal and negotiator, off
-     * for reporter.
+     * produce those blocks — enabled for onboarding, signal and negotiator.
      */
     hallucinationRecovery: boolean;
 }

package/dist/chat/chat.prompt.js

@@ -4,7 +4,7 @@
 //
 // Persona-neutral prompt text owned by the agent loop rather than by any one
 // persona. Each persona builds its own system prompt (see signal.prompt.ts,
-// negotiator.prompt.ts, reporter.prompt.ts, onboarding.prompt.ts); what remains
+// negotiator.prompt.ts, onboarding.prompt.ts); what remains
 // here is only what the loop itself injects regardless of persona.
 /**
  * Nudge message injected after SOFT_ITERATION_LIMIT iterations.

package/dist/chat/chat.prompt.modules.d.ts

@@ -11,8 +11,6 @@ export interface IterationContext {
     }>;
     /** Text of the latest user message (for regex matching). */
     currentMessage?: string;
-    /** Whether an earlier assistant turn visibly contained a valid action proposal. */
-    hasPriorAgentActionProposal?: boolean;
     /** Resolved tool context (user, profile, indexes, etc.). */
     ctx: ResolvedToolContext;
 }

package/dist/index.d.ts

@@ -35,7 +35,6 @@ export { ChatGraphFactory } from "./agents/index.js";
 export { type ChatPersonaConfig } from "./agents/index.js";
 export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "./agents/index.js";
 export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, } from "./agents/index.js";
-export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, } from "./agents/index.js";
 export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, } from "./agents/index.js";
 export { RadarGraphFactory } from "./opportunities/index.js";
 export { HydeGraphFactory } from "./discovery/index.js";

package/dist/index.js

@@ -31,7 +31,6 @@ export { DEFAULT_NETWORK_ASSIGNMENT_THRESHOLD, resolveAssignmentNetworkScope, bu
 export { ChatGraphFactory } from "./agents/index.js";
 export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "./agents/index.js";
 export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, } from "./agents/index.js";
-export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, } from "./agents/index.js";
 export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, } from "./agents/index.js";
 export { RadarGraphFactory } from "./opportunities/index.js";
 export { HydeGraphFactory } from "./discovery/index.js";

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