@indexnetwork/protocol 6.12.0-rc.403.1 → 6.13.22-rc.405.1

package/dist/questioner/questioner.tools.js

@@ -1,188 +1,5 @@
-import { z } from "zod";
-import { error, success } from "../shared/agent/tool.helpers.js";
-import { focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../shared/agent/tool.scope.js";
 /**
- * Detection modes whose questions derive solely from the caller's own data
- * (profile gaps, own intents, own discovery sessions). Negotiation-mode
- * questions are excluded for network-scoped agents: their prompts are seeded
- * from opportunity metadata that can reference out-of-scope networks and
- * other users' content (same leak class as the getOpportunitiesForUser fix).
+ * @deprecated Canonical location: questions/application/question.tools — retained
+ * for backward compatibility (IND-547).
  */
-const SELF_OWNED_MODES = ["enrichment", "intent", "discovery"];
-function isVisibleInScopedNetwork(question, userId, networkId) {
-    return question.actors?.some((actor) => actor.userId === userId && actor.networkId === networkId) === true;
-}
-function stripInternalQuestionFields(question) {
-    const { actors: _actors, purpose: _purpose, ...publicQuestion } = question;
-    return publicQuestion;
-}
-/**
- * Creates MCP tool definitions for the questioner domain.
- * Exposes `read_pending_questions` for retrieving the caller's pending
- * questions generated by QuestionerAgent (enrichment, intent, negotiation, discovery modes).
- *
- * Network-scoped agent keys (context.scopeType/scopeId set via applyNetworkScopeToContext)
- * are clamped to self-owned modes; the result then carries a `scopeRestriction`
- * block mirroring the network-tools convention.
- *
- * @param defineTool - Tool factory provided by the composition root.
- * @param deps       - Shared tool dependencies; `findPendingQuestions` and
- *                     `answerPendingQuestion` are optional and the tools fail
- *                     gracefully when absent.
- */
-export function createQuestionerTools(defineTool, deps) {
-    const readPendingQuestions = defineTool({
-        name: "read_pending_questions",
-        description: "Returns pending questions generated for the authenticated user across all modes " +
-            "(profile, intent, negotiation, discovery). These are questions generated by the " +
-            "system to help surface missing signals, refine intents, or capture engagement context.\n\n" +
-            "**Returns:** List of pending questions, each with `id`, `title`, `prompt`, `options`, " +
-            "`multiSelect`, `mode`, `sourceType`, `sourceId`, `createdAt`, and optional `expiresAt`. " +
-            "Network-scoped agents receive only profile/intent/discovery questions for the scoped network plus a " +
-            "`scopeRestriction` note.\n\n" +
-            "**Use:** Call with no arguments to get all pending questions, or pass `limit` to cap the " +
-            "count. For the daily brief the script calls with a small `limit` and renders the first " +
-            "question that has not been delivered yet.",
-        querySchema: z.object({
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(10)
-                .optional()
-                .describe("Maximum number of questions to return (1-10, default 10)."),
-        }),
-        handler: async ({ context, query }) => {
-            if (!deps.findPendingQuestions) {
-                return error("Question lookup is not available.");
-            }
-            const limit = query.limit ?? 10;
-            // Scoped-key discriminator: scoped contexts carry a scope envelope.
-            const scopedNetworkId = focusedNetworkId(context);
-            const scopedIntentId = focusedIntentId(context);
-            const isNetworkScoped = Boolean(scopedNetworkId);
-            const isIntentScoped = Boolean(scopedIntentId);
-            try {
-                const fetched = await deps.findPendingQuestions(context.userId, {
-                    ...(isNetworkScoped ? { modes: SELF_OWNED_MODES, networkId: scopedNetworkId } : {}),
-                    ...(isIntentScoped ? { scopeType: 'intent', scopeId: scopedIntentId } : {}),
-                    limit,
-                });
-                // Defense-in-depth: hosts apply `modes`/`networkId`/`limit` SQL-side;
-                // re-apply all three here so the network clamp holds even when a custom
-                // dep ignores the filters. Scoped rows without actor network metadata are
-                // hidden fail-closed because they cannot prove membership in this scope.
-                const visible = isNetworkScoped
-                    ? fetched.filter((q) => SELF_OWNED_MODES.includes(q.mode) &&
-                        isVisibleInScopedNetwork(q, context.userId, scopedNetworkId))
-                    : fetched;
-                const limited = visible.slice(0, limit).map(stripInternalQuestionFields);
-                if (isIntentScoped) {
-                    return success({
-                        questions: limited,
-                        scopeRestriction: {
-                            isScoped: true,
-                            scopedToIntent: scopedIntentId,
-                            message: "Results are restricted to the selected intent, including direct intent questions and negotiation questions from matching opportunities.",
-                        },
-                    });
-                }
-                if (isNetworkScoped) {
-                    return success({
-                        questions: limited,
-                        scopeRestriction: {
-                            isScoped: true,
-                            scopedToIndex: focusedNetworkLabel(context),
-                            message: `Results are restricted to "${context.indexName ?? "this network"}" and ` +
-                                `exclude negotiation questions because this agent is scoped to that index.`,
-                        },
-                    });
-                }
-                return success({ questions: limited });
-            }
-            catch (err) {
-                deps.reportToolError?.(err, {
-                    operation: "read-pending-questions",
-                    toolName: "read_pending_questions",
-                    userId: context.userId,
-                });
-                return error("Failed to read pending questions.");
-            }
-        },
-    });
-    const answerPendingQuestion = defineTool({
-        name: "answer_pending_question",
-        description: "Records the client's explicit answer to one of their pending questions (from " +
-            "read_pending_questions) through the standard answer pipeline — the same one the " +
-            "question cards in the app use. Downstream effects (signal refinement, negotiation " +
-            "context, profile enrichment) fire exactly as if the client answered the card.\n\n" +
-            "**Use ONLY with an answer the client explicitly gave in this conversation.** Never " +
-            "infer, summarize, or invent an answer on their behalf. Pass the client's chosen " +
-            "option labels in `selectedOptions` and/or their own words in `freeText`.\n\n" +
-            "**Returns:** `answered: true` on success. If the question was already answered, " +
-            "dismissed, or expired, the tool reports that — tell the client instead of retrying.",
-        querySchema: z.object({
-            questionId: z.string().min(1).describe("Id of the pending question being answered (from read_pending_questions)."),
-            selectedOptions: z
-                .array(z.string().min(1))
-                .max(10)
-                .optional()
-                .describe("Option labels the client explicitly chose, when the question has options."),
-            freeText: z
-                .string()
-                .max(2000)
-                .optional()
-                .describe("The client's answer in their own words, for free-form answers or an 'other' option."),
-        }),
-        handler: async ({ context, query }) => {
-            if (!deps.answerPendingQuestion || !deps.findPendingQuestions) {
-                return error("Question answering is not available.");
-            }
-            // Client-surface action: network-scoped agent keys act inside one
-            // community and must not settle the user's global question inbox
-            // (same leak class as the SELF_OWNED_MODES clamp above).
-            if (focusedNetworkId(context)) {
-                return error("Answering questions is not available for network-scoped agents.");
-            }
-            const selectedOptions = (query.selectedOptions ?? []).map((option) => option.trim()).filter(Boolean);
-            const freeText = query.freeText?.trim();
-            if (selectedOptions.length === 0 && !freeText) {
-                return error("No answer provided. Pass the client's explicit answer via selectedOptions and/or freeText — never answer on their behalf.");
-            }
-            const scopedIntentId = focusedIntentId(context);
-            try {
-                // Visibility check under the same clamps as read_pending_questions:
-                // an intent-pinned session may only answer questions it can list.
-                const pending = await deps.findPendingQuestions(context.userId, {
-                    ...(scopedIntentId ? { scopeType: 'intent', scopeId: scopedIntentId } : {}),
-                });
-                const target = pending.find((q) => q.id === query.questionId);
-                if (!target) {
-                    return error("Question not found among the client's pending questions — it may already be answered or dismissed. Re-check with read_pending_questions.");
-                }
-                const answered = await deps.answerPendingQuestion(context.userId, query.questionId, {
-                    selectedOptions,
-                    ...(freeText ? { freeText } : {}),
-                });
-                if (!answered) {
-                    return error("The question was already answered or dismissed — nothing was recorded.");
-                }
-                return success({
-                    answered: true,
-                    question: { id: target.id, title: target.title, prompt: target.prompt },
-                    recordedAnswer: { selectedOptions, ...(freeText ? { freeText } : {}) },
-                });
-            }
-            catch (err) {
-                deps.reportToolError?.(err, {
-                    operation: "answer-pending-question",
-                    toolName: "answer_pending_question",
-                    userId: context.userId,
-                });
-                return error("Failed to record the answer.");
-            }
-        },
-    });
-    return [readPendingQuestions, answerPendingQuestion];
-}
-//# sourceMappingURL=questioner.tools.js.map
+export { createQuestionerTools } from "../questions/application/question.tools.js";

package/dist/questioner/questioner.types.d.ts

@@ -1,220 +1,6 @@
 /**
- * QuestionerAgent input types. The `QuestionerInput` envelope carries a `mode`
- * field that selects a preset, plus a polymorphic `context` that varies per mode.
- *
- * Slice 1 defines all four context shapes but only `DiscoveryContext` has a
- * working preset implementation. The others are type stubs for future slices.
+ * @deprecated Canonical location: questions/application/question.input — retained
+ * for backward compatibility (IND-547).
  */
-import type { DiscoveryQuestionInput } from "../shared/schemas/discovery-question.schema.js";
-import type { ToolScopeType } from "../shared/agent/tool.scope.js";
-import type { NegotiationQuestionCandidate, QuestionMode, QuestionPoolDiscriminator } from "../shared/schemas/question.schema.js";
-import type { NegotiationConsultationReason } from "../negotiation/negotiation.consultation-policy.js";
-/**
- * Discovery context — wraps the existing DiscoveryQuestionInput wholesale.
- * The discovery preset's buildPrompt delegates to `questioner.discovery.prompt.ts`.
- */
-export type DiscoveryContext = DiscoveryQuestionInput;
-/** Intent context — data needed to generate questions about an intent. */
-export interface IntentContext {
-    intentId: string;
-    payload: string;
-    summary?: string;
-    /** The user's global user_context paragraph (profile-replacing identity text). */
-    userContext?: string;
-}
-/** Recovery-only intent context after a successful discovery completion. */
-export interface RecoveryIntentContext extends IntentContext {
-    purpose: "recovery";
-    /** Privacy-safe aggregate signal; raw negotiation evidence is never provided. */
-    rejectedNegotiationCount?: number;
-}
-/** Profile context — data needed to generate questions to fill profile gaps. */
-export interface ProfileContext {
-    /** The user's global user_context paragraph (profile-replacing identity text). */
-    userContext?: string;
-    gaps: string[];
-    /** Existing premise texts the user has already stated (e.g. "I live in Berlin"). */
-    existingPremises?: string[];
-}
-/** Shared context fields for negotiation-mode questions. */
-interface NegotiationContextBase {
-    negotiationId: string;
-    /** Privacy-reviewed generic description; never raw counterparty identity/profile. */
-    counterpartyHint: string;
-    /** Source-safe network label, never an internal prompt or identifier. */
-    indexContext: string;
-    /** The user's global user_context paragraph (profile-replacing identity text). */
-    userContext?: string;
-}
-/** Post-stall negotiation context. Preserves the existing source shape. */
-export interface PostStallNegotiationContext extends NegotiationContextBase {
-    purpose?: undefined;
-    outcomeReason: "turn_cap" | "timeout" | "stalled";
-    /** The recipient's own exact opportunity-bound signal, never evaluator reasoning. */
-    recipientIntent: string;
-}
-/** Pre-accept uptake context targeting a counterparty's preparatory conditions. */
-export interface UptakeNegotiationContext extends NegotiationContextBase {
-    purpose: "uptake";
-    /** Plain-language activity or commitment whose feasibility needs clarification. */
-    proposedActivity: string;
-}
-/** Negotiation context discriminated by internal question purpose. */
-export type NegotiationContext = PostStallNegotiationContext | UptakeNegotiationContext;
-/**
- * Negotiation-inflight context — a negotiator mid-negotiation wants to ask its
- * OWN client a question before continuing (the `ask_user` action, P3.2). The
- * negotiator states the disclosure subject and optionally drafts the question;
- * the QuestionerAgent refines it into polished disclosure-gating questions.
- * Distinct from {@link NegotiationContext}, which covers post-stall questions.
- */
-export interface NegotiationInflightContext {
-    negotiationId: string;
-    /** Anonymized counterparty description (attributes, never identity). */
-    counterpartyHint: string;
-    /** What the negotiator wants permission to share or needs to know (e.g. "budget range", "availability in Q3"). */
-    disclosureSubject: string;
-    /** Draft question authored by the negotiator. The agent refines it. */
-    draftQuestion?: string;
-    /** Community / index context the negotiation runs in. */
-    indexContext: string;
-    /** Server-only IND-508 reason; never copied into generated or persisted payloads. */
-    consultationPolicyReason?: NegotiationConsultationReason;
-    /** The user's global user_context paragraph (profile-replacing identity text). */
-    userContext?: string;
-}
-/**
- * Chat context — data for orchestrator-initiated mid-conversation questions
- * (the `ask_user_question` tool). The orchestrator states what it needs to
- * learn; the QuestionerAgent turns that into polished structured questions,
- * grounded in the recent conversation and the user's identity context.
- */
-export interface ChatContext {
-    /** What the orchestrator needs to learn and why (authored by the chat model). */
-    purpose: string;
-    /** Draft questions proposed by the orchestrator. The agent refines these. */
-    draftQuestions?: Array<{
-        prompt: string;
-        options?: string[];
-        multiSelect?: boolean;
-    }>;
-    /** Recent conversation excerpt for grounding (most recent messages last). */
-    conversationExcerpt?: string;
-    /** The user's global user_context paragraph (profile-replacing identity text). */
-    userContext?: string;
-}
-/**
- * Pool-discovery context — mined discriminators from a discovery-run pool
- * (IND-418). No generator LLM runs for this mode: the QuestionerQueue
- * synthesizes the question deterministically from the top discriminator and
- * stashes the rest as interview-mode alternates.
- */
-export interface PoolDiscoveryContext {
-    intentId: string;
-    /** Truncated intent payload (+ summary) display snippet. */
-    intentText: string;
-    /** Stable hash of the full normalized payload + summary used for freshness. */
-    intentFingerprint?: string;
-    poolSize: number;
-    /** Exact bounded candidate opportunity IDs supplied to synthesis. */
-    opportunityIds: string[];
-    /** Discovery run that produced the pool. */
-    runId?: string;
-    /** Eligible discriminators, VoI-descending (asked + chain alternates). */
-    discriminators: QuestionPoolDiscriminator[];
-    /** ISO-8601 timestamp of the mining pass. */
-    minedAt: string;
-}
-/** Discriminated union: mode selects the context shape. */
-export type QuestionerContext = DiscoveryContext | IntentContext | RecoveryIntentContext | ProfileContext | NegotiationContext | NegotiationInflightContext | ChatContext | PoolDiscoveryContext;
-/**
- * Payload shape accepted by the questionerEnqueue callback. Covers all
- * question modes — the composition root bridges this to the concrete
- * QuestionerQueue.
- */
-export type QuestionerEnqueuePayload = QuestionerInput;
-/** Callback signature for async question generation enqueue. */
-export type QuestionerEnqueueFn = (input: QuestionerEnqueuePayload) => Promise<void>;
-/** Top-level input envelope for QuestionerAgent.invoke(). */
-interface QuestionerInputBase {
-    /** Selects the preset (system prompt + builder). */
-    mode: QuestionMode;
-    /** User the questions are generated for. */
-    userId: string;
-    /** Entity type that triggered this (e.g. "opportunity", "intent", "profile"). */
-    sourceType: string;
-    /** ID of the triggering entity. */
-    sourceId: string;
-    /** Scoped question context. Network scopes persist as QuestionActor.networkId. */
-    scopeType?: ToolScopeType;
-    /** Scoped question id. When scopeType is `network`, this is the actor networkId. */
-    scopeId?: string;
-    /**
-     * Intent that triggered the run that generated these questions. Persisted as
-     * `detection.triggeredBy` so intent-scoped surfaces (e.g. the intent page)
-     * can find them. Independent of `scopeType`/`scopeId`, which may carry a
-     * network scope at the same time.
-     */
-    triggeredByIntentId?: string;
-    /** Conversation ID — set when the question originates from a chat session. Persisted on the question row for frontend filtering. */
-    conversationId?: string;
-    /** Assistant message ID — set when we know which message triggered the question. Stored in detection.messageId for inline anchoring. */
-    messageId?: string;
-    /**
-     * Candidate exact binding for negotiation-family jobs. The API/DB must
-     * authoritatively re-resolve it before generation and again before insert.
-     */
-    negotiation?: NegotiationQuestionCandidate;
-}
-/** Non-negotiation modes cannot smuggle negotiation purpose/provenance. */
-interface StandardQuestionerInput extends QuestionerInputBase {
-    mode: Exclude<QuestionMode, "negotiation" | "negotiation_inflight">;
-    purpose?: never;
-    negotiation?: never;
-    context: Exclude<QuestionerContext, NegotiationContext | NegotiationInflightContext | RecoveryIntentContext>;
-}
-/** Ordinary post-stall generation is task-backed and uses only the ordinary preset. */
-export interface PostStallQuestionerInput extends QuestionerInputBase {
-    mode: "negotiation";
-    purpose: "stalled_followup";
-    negotiation: NegotiationQuestionCandidate & {
-        purpose: "stalled_followup";
-        taskId: string;
-    };
-    context: PostStallNegotiationContext;
-}
-/** Mid-negotiation consultation is task-backed and uses only structured ask_user fields. */
-export interface InflightQuestionerInput extends QuestionerInputBase {
-    mode: "negotiation_inflight";
-    purpose: "inflight_consultation";
-    negotiation: NegotiationQuestionCandidate & {
-        purpose: "inflight_consultation";
-        taskId: string;
-    };
-    context: NegotiationInflightContext;
-}
-/** Negotiation-mode uptake generation input. */
-export interface UptakeQuestionerInput extends QuestionerInputBase {
-    mode: "negotiation";
-    purpose: "uptake";
-    negotiation: NegotiationQuestionCandidate & {
-        purpose: "uptake";
-        taskId?: undefined;
-    };
-    context: UptakeNegotiationContext;
-}
-/** Intent-mode post-discovery recovery generation input. */
-export interface RecoveryQuestionerInput extends QuestionerInputBase {
-    mode: "intent";
-    purpose: "recovery";
-    sourceType: "intent";
-    triggeredByIntentId: string;
-    negotiation?: never;
-    context: RecoveryIntentContext;
-}
-/** Top-level input discriminated by both mode and internal purpose. */
-export type QuestionerInput = StandardQuestionerInput | PostStallQuestionerInput | InflightQuestionerInput | UptakeQuestionerInput | RecoveryQuestionerInput;
-/** Runtime mirror of the mode/purpose/context discriminant used at queue boundaries. */
-export declare function isValidQuestionerInputContract(input: QuestionerInput): boolean;
-export {};
-//# sourceMappingURL=questioner.types.d.ts.map
+export { isValidQuestionerInputContract, } from "../questions/application/question.input.js";
+export type { DiscoveryContext, IntentContext, RecoveryIntentContext, ProfileContext, PostStallNegotiationContext, UptakeNegotiationContext, NegotiationContext, NegotiationInflightContext, ChatContext, PoolDiscoveryContext, QuestionerContext, QuestionerEnqueuePayload, QuestionerEnqueueFn, QuestionerInput, PostStallQuestionerInput, InflightQuestionerInput, UptakeQuestionerInput, RecoveryQuestionerInput, } from "../questions/application/question.input.js";

package/dist/questioner/questioner.types.js

@@ -1,62 +1,5 @@
-import { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, NEGOTIATION_QUESTION_GENERIC_UPTAKE_ACTIVITY, isSafeNegotiationQuestionText } from "../negotiation/negotiation.question-safety.js";
-/** Runtime mirror of the mode/purpose/context discriminant used at queue boundaries. */
-export function isValidQuestionerInputContract(input) {
-    if (input.purpose === 'recovery') {
-        const context = input.context;
-        return input.mode === 'intent'
-            && input.sourceType === 'intent'
-            && input.triggeredByIntentId === input.sourceId
-            && input.negotiation === undefined
-            && context.purpose === 'recovery'
-            && context.intentId === input.sourceId;
-    }
-    if (input.mode !== 'negotiation' && input.mode !== 'negotiation_inflight') {
-        return input.purpose === undefined && input.negotiation === undefined;
-    }
-    if (input.sourceType !== 'opportunity'
-        || !input.negotiation
-        || input.negotiation.opportunityId !== input.sourceId
-        || input.negotiation.recipientUserId !== input.userId
-        || input.negotiation.purpose !== input.purpose)
-        return false;
-    const context = input.context;
-    if (context.counterpartyHint !== NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY
-        || context.indexContext !== NEGOTIATION_QUESTION_GENERIC_NETWORK)
-        return false;
-    if (input.mode === 'negotiation_inflight') {
-        return input.purpose === 'inflight_consultation'
-            && typeof input.negotiation.taskId === 'string'
-            && input.negotiation.taskId.length > 0
-            && context.negotiationId === input.negotiation.taskId
-            && typeof context.disclosureSubject === 'string'
-            && isSafeNegotiationQuestionText(context.disclosureSubject)
-            && (context.consultationPolicyReason === undefined
-                || context.consultationPolicyReason === 'unresolved_owner_constraint'
-                || context.consultationPolicyReason === 'consequential_disclosure_permission'
-                || context.consultationPolicyReason === 'repeated_non_convergence'
-                || context.consultationPolicyReason === 'insufficient_commitment_authority')
-            && (context.draftQuestion === undefined
-                || (typeof context.draftQuestion === 'string' && isSafeNegotiationQuestionText(context.draftQuestion)));
-    }
-    if (input.purpose === 'uptake') {
-        return input.negotiation.taskId === undefined
-            && typeof input.negotiation.counterpartyUserId === 'string'
-            && input.negotiation.counterpartyUserId.length > 0
-            && typeof input.negotiation.counterpartyIntentId === 'string'
-            && input.negotiation.counterpartyIntentId.length > 0
-            && typeof input.negotiation.counterpartyFelicityAuthority === 'number'
-            && Number.isFinite(input.negotiation.counterpartyFelicityAuthority)
-            && context.negotiationId === input.sourceId
-            && context.purpose === 'uptake'
-            && context.proposedActivity === NEGOTIATION_QUESTION_GENERIC_UPTAKE_ACTIVITY;
-    }
-    return input.purpose === 'stalled_followup'
-        && typeof input.negotiation.taskId === 'string'
-        && input.negotiation.taskId.length > 0
-        && context.negotiationId === input.negotiation.taskId
-        && context.purpose === undefined
-        && (context.outcomeReason === 'turn_cap' || context.outcomeReason === 'timeout' || context.outcomeReason === 'stalled')
-        && typeof context.recipientIntent === 'string'
-        && context.recipientIntent.trim().length > 0;
-}
-//# sourceMappingURL=questioner.types.js.map
+/**
+ * @deprecated Canonical location: questions/application/question.input — retained
+ * for backward compatibility (IND-547).
+ */
+export { isValidQuestionerInputContract, } from "../questions/application/question.input.js";

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

@@ -0,0 +1,39 @@
+/**
+ * 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, DiscoveryContext, IntentContext, RecoveryIntentContext, ProfileContext, 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, isDiscoveryQuestionsEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, discoveryQuestionsInputMode, discoveryQuestionsTimeoutMs, chatQuestionWaitTimeoutMs, DISCOVERY_QUESTIONS_TIMEOUT_MS_DEFAULT, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } 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

@@ -0,0 +1,41 @@
+/**
+ * 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, isDiscoveryQuestionsEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, discoveryQuestionsInputMode, discoveryQuestionsTimeoutMs, chatQuestionWaitTimeoutMs, DISCOVERY_QUESTIONS_TIMEOUT_MS_DEFAULT, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } 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.agent.d.ts

@@ -0,0 +1,28 @@
+import { type QuestionGenerationResult } from "../domain/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. */
+    modelConfig?: Parameters<typeof createStructuredModel>[3];
+}
+/**
+ * Stateless question-generation agent. Accepts a `QuestionerInput` envelope,
+ * selects the preset for the given mode, invokes the LLM, and applies
+ * guardrails (dedup + strategy diversity).
+ */
+export declare class QuestionerAgent {
+    private model;
+    constructor(config?: QuestionerAgentConfig);
+    /**
+     * Generate up to 3 decision questions from the given input.
+     *
+     * @param input  Envelope with mode, userId, source info, and mode-specific context.
+     * @param options.signal  Optional AbortSignal to cancel the in-flight LLM call.
+     * @returns A result with parallel questions[] and strategies[] arrays,
+     *   or null when generation failed, guardrails dropped all candidates,
+     *   the LLM threw, or the call was aborted.
+     */
+    invoke(input: QuestionerInput, options?: {
+        signal?: AbortSignal;
+    }): Promise<QuestionGenerationResult | null>;
+}