@indexnetwork/protocol 21.1.0-rc.493.1 → 22.0.0-rc.494.1

package/dist/opportunities/opportunity.graph.d.ts

@@ -733,7 +733,7 @@ export declare class OpportunityGraphFactory {
             seedAssessmentScore?: number | undefined;
         }[]> | undefined;
         discoverySummary?: import("../shared/schemas/discovery-question.schema.js").DiscoverySummary | import("@langchain/langgraph").OverwriteValue<import("../shared/schemas/discovery-question.schema.js").DiscoverySummary | null> | null | undefined;
-    }, "scope" | "__start__" | "discovery" | "prep" | "evaluation" | "persist" | "negotiate" | "resolve" | "ranking", {
+    }, "scope" | "__start__" | "prep" | "discovery" | "evaluation" | "persist" | "negotiate" | "resolve" | "ranking", {
         userId: import("@langchain/langgraph").BaseChannel<import("./opportunity.graph.shared.js").Id<"users">, import("./opportunity.graph.shared.js").Id<"users"> | import("@langchain/langgraph").OverwriteValue<import("./opportunity.graph.shared.js").Id<"users">>, unknown>;
         searchQuery: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkId: import("@langchain/langgraph").BaseChannel<import("./opportunity.graph.shared.js").Id<"networks"> | undefined, import("./opportunity.graph.shared.js").Id<"networks"> | import("@langchain/langgraph").OverwriteValue<import("./opportunity.graph.shared.js").Id<"networks"> | undefined> | undefined, unknown>;

package/dist/opportunities/opportunity.tools.cards.d.ts

@@ -8,7 +8,6 @@
 import { type OpportunityOwnerAction, type OpportunityOwnerApprovalVerdict } from "./opportunity.owner-approval.js";
 export declare function stripLeadingNarratorName(remark: string, narratorName: string): string;
 import type { Opportunity } from "../shared/interfaces/database.interface.js";
-import type { PendingQuestionSummary } from "../shared/schemas/pending-question.schema.js";
 export declare const logger: import("../shared/observability/log.js").LoggerWithSource;
 /**
  * Build the agent-facing profile link for a counterpart — always the Index web
@@ -72,18 +71,6 @@ export declare function attachOpportunityAppLink(card: Record<string, unknown> &
 }, opts: {
     frontendUrl: string | undefined;
 }): void;
-export interface PublicUptakeQuestion {
-    id: string;
-    title: string;
-    prompt: string;
-    options: Array<{
-        label: string;
-        description: string;
-    }>;
-    multiSelect: boolean;
-}
-export declare function publicUptakeQuestion(question: PendingQuestionSummary): PublicUptakeQuestion;
-export declare function uptakeAdvisory(opportunityId: string, questions: PublicUptakeQuestion[]): string;
 /**
  * IND-593: stable fail-closed denial for the owner-approval boundary. The
  * `missing` reason carries the fresh, server-derived interaction challenge the

package/dist/opportunities/opportunity.tools.cards.js

@@ -111,28 +111,6 @@ export function attachOpportunityAppLink(card, opts) {
     if (appUrl)
         card.appUrl = appUrl;
 }
-export function publicUptakeQuestion(question) {
-    return {
-        id: question.id,
-        title: question.title,
-        prompt: question.prompt,
-        options: question.options,
-        multiSelect: question.multiSelect,
-    };
-}
-export function uptakeAdvisory(opportunityId, questions) {
-    return JSON.stringify({
-        success: false,
-        error: "Resolve the pending uptake questions or explicitly continue anyway.",
-        advisory: {
-            code: "unresolved_uptake_questions",
-            advisoryOnly: true,
-            opportunityId,
-            questions,
-            acknowledgedUptakeQuestionIds: questions.map((question) => question.id),
-        },
-    });
-}
 /**
  * IND-593: stable fail-closed denial for the owner-approval boundary. The
  * `missing` reason carries the fresh, server-derived interaction challenge the

package/dist/opportunities/opportunity.tools.js

@@ -10,14 +10,13 @@ import { requestContext } from "../shared/observability/request-context.js";
 import { success, error, UUID_REGEX } from "../shared/agent/tool.helpers.js";
 import { focusedIntentId, focusedNetworkId } from "../shared/agent/tool.scope.js";
 import { OpportunityPresenter, gatherPresenterContext } from "./opportunity.presentation.js";
-import { isUptakeGuardEnabled } from "../questions/question.module.js";
 import { admitOpportunityUpdate } from "./opportunity.update-admission.js";
 import { opportunityOwnerActionForStatus } from "./opportunity.owner-approval.js";
 import { ownerApprovalProvenanceFor } from "./opportunity.owner-provenance.js";
 export { buildOpportunityPresentation } from "./opportunity.presentation.js";
 import { sendOpportunity, updateOpportunityStatus } from "./opportunity.graph.modes.js";
 import { createListOpportunitiesTool } from "./opportunity.tools.list.js";
-import { confirmDeliveryError, logger, ownerApprovalDenial, publicUptakeQuestion, uptakeAdvisory } from "./opportunity.tools.cards.js";
+import { confirmDeliveryError, logger, ownerApprovalDenial } from "./opportunity.tools.cards.js";
 export { attachOpportunityAppLink, attachProfileLink, buildMinimalOpportunityCard, buildNegotiationUrl, buildOpportunityAppUrl, buildProfileUrl } from "./opportunity.tools.cards.js";
 export function createOpportunityTools(defineTool, deps) {
     const { database, userDb, systemDb, graphs, cache } = deps;
@@ -36,13 +35,12 @@ export function createOpportunityTools(defineTool, deps) {
             "- `rejected`: Decline a received opportunity.\n" +
             "- `expired`: Mark as expired (typically done by the system after timeout).\n\n" +
             "**When to use:** After list_opportunities returns persisted opportunity cards. " +
-            "The user clicks 'Send' (pending), 'Accept', or 'Reject' on the card, and the agent calls this tool. " +
-            "An accepted transition may first return a non-success uptake advisory with preparatory questions. Surface those questions, then retry with all returned question ids in acknowledgedUptakeQuestionIds; acknowledgement confirms presentation, not an answer.\n\n" +
+            "The user clicks 'Send' (pending), 'Accept', or 'Reject' on the card, and the agent calls this tool.\n\n" +
             "**Owner approval (agents):** Agent-driven send/accept/reject transitions require an explicit owner-issued approval proof. " +
             "Call without ownerApprovalProof first: the denial returns an approval challenge (interactionId, expiresAt) bound to the exact opportunity, action, owner, and agent. " +
             "Relay that challenge to the owner for explicit approval, then retry once with the issued ownerApprovalProof. " +
-            "Proofs are single-use and expire; acknowledgedUptakeQuestionIds, negotiation approvals, and advisory values are never substitutes.\n\n" +
-            "**Returns:** Confirmation with the new status and notification details (who was notified), or a structured uptake advisory without mutation.",
+            "Proofs are single-use and expire; negotiation approvals and advisory values are never substitutes.\n\n" +
+            "**Returns:** Confirmation with the new status and notification details (who was notified).",
         querySchema: z.object({
             opportunityId: z
                 .string()
@@ -58,10 +56,6 @@ export function createOpportunityTools(defineTool, deps) {
                 .describe("Opaque owner-issued approval proof for this exact transition (agents only). Obtained after the owner " +
                 "explicitly approves the interaction challenge returned by a proof-less call. The opportunity, action, " +
                 "owner, agent, and interaction binding is always derived server-side; only this token is presented."),
-            acknowledgedUptakeQuestionIds: z
-                .array(z.string().min(1))
-                .optional()
-                .describe("On an acknowledged retry after an uptake advisory, include every question id returned by that advisory."),
             scopeType: z
                 .enum(['intent'])
                 .optional()
@@ -137,61 +131,6 @@ export function createOpportunityTools(defineTool, deps) {
                 if (verdict.kind === 'denied')
                     return ownerApprovalDenial(opportunityId, ownerAction, verdict);
             }
-            // The caller actor's own network is the exact question lookup boundary,
-            // even for an otherwise unscoped request. A focused network may only be
-            // equal to this after the guard above.
-            // Unscoped callers query all of their exact opportunity questions; a
-            // network-scoped caller is clamped to the bound network. Selecting the
-            // first duplicate actor row would miss a valid question on another
-            // shared network.
-            const uptakeNetworkId = scopedNetworkId;
-            // Soft uptake interlock: only acceptance is advisory-gated. All existing
-            // actor/scope/privacy guards run first so the question lookup cannot be
-            // used to probe opportunities or networks the caller cannot access.
-            if (query.status === "accepted" && isUptakeGuardEnabled() && deps.findPendingQuestions) {
-                try {
-                    const pending = await deps.findPendingQuestions(context.userId, {
-                        sourceType: "opportunity",
-                        sourceId: opportunityId,
-                        modes: ["negotiation"],
-                        purpose: "uptake",
-                        ...(uptakeNetworkId ? { networkId: uptakeNetworkId } : {}),
-                    });
-                    // Defense in depth if a host overlooks one or more filters. Actor
-                    // internals are checked here and never serialized into the advisory.
-                    const exactPending = pending.filter((question) => {
-                        if (question.sourceType !== "opportunity" ||
-                            question.sourceId !== opportunityId ||
-                            question.mode !== "negotiation" ||
-                            question.purpose !== "uptake") {
-                            return false;
-                        }
-                        if (!question.actors?.some((actor) => actor.userId === context.userId))
-                            return false;
-                        if (uptakeNetworkId && !question.actors.some((actor) => actor.userId === context.userId && actor.networkId === uptakeNetworkId)) {
-                            return false;
-                        }
-                        return true;
-                    });
-                    const acknowledged = new Set(query.acknowledgedUptakeQuestionIds ?? []);
-                    if (exactPending.some((question) => !acknowledged.has(question.id))) {
-                        return uptakeAdvisory(opportunityId, exactPending.map(publicUptakeQuestion));
-                    }
-                }
-                catch (err) {
-                    logger.warn("update_opportunity: uptake question lookup failed open", {
-                        opportunityId,
-                        userId: context.userId,
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                    deps.reportToolError?.(err, {
-                        subsystem: "opportunity",
-                        operation: "opportunity.uptake_lookup",
-                        toolName: "update_opportunity",
-                        userId: context.userId,
-                    });
-                }
-            }
             const isSend = query.status === "pending";
             const _updateGraphStart = Date.now();
             const _updateTraceEmitter = requestContext.getStore()?.traceEmitter;

package/dist/opportunities/opportunity.tools.port.d.ts

@@ -11,6 +11,6 @@ export interface OpportunityOwnerApprovalDeps {
     opportunityOwnerApproval?: OpportunityOwnerApprovalAuthority;
 }
 /** Host capabilities consumed by opportunity discovery, delivery, and presentation tools. */
-export type OpportunityToolDeps = Pick<ToolRegistryCompositionDeps, "database" | "userDb" | "systemDb" | "cache" | "chatSummary" | "opportunityPresentation" | "questionerEnqueue" | "findPendingQuestions" | "negotiationSummary" | "negotiationDatabase" | "deliveryLedger" | "frontendUrl" | "stampNewbornOpportunities" | "reportToolError" | "opportunityOperations"> & OpportunityOwnerApprovalDeps & {
+export type OpportunityToolDeps = Pick<ToolRegistryCompositionDeps, "database" | "userDb" | "systemDb" | "cache" | "chatSummary" | "opportunityPresentation" | "questionerEnqueue" | "negotiationSummary" | "negotiationDatabase" | "deliveryLedger" | "frontendUrl" | "stampNewbornOpportunities" | "reportToolError" | "opportunityOperations"> & OpportunityOwnerApprovalDeps & {
     graphs: Pick<ToolRegistryCompositionDeps["graphs"], "index" | "networkMembership" | "opportunity">;
 };

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

@@ -1,26 +1,11 @@
 /**
- * questions/question.env — centralized question-generation env accessors.
+ * questions/question.env — leftover question env constants.
  *
- * Naming scheme (one prefix, hierarchical):
- *
- *   QUESTIONER_ENABLED                  master switch — QuestionerQueue worker +
- *                                       enqueue closures at every composition site.
- *   QUESTIONER_UPTAKE_ENABLED           per-surface switch — advisory pre-accept uptake
- *                                       interlock. Requires the master switch.
- *   QUESTIONER_UPTAKE_AUTHORITY_THRESHOLD
- *                                       authority threshold (0-100, default 70).
- *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
- *                                       tool waits for an inline answer (default 4 min).
- *   QUESTIONER_INTENT_DAILY_CAP         refinement questions one intent may generate
- *                                       per rolling 24h, recovery + pool combined
- *                                       (default 2; 0 disables refinement).
- *
- * All reads go through this module — do not read these variables via
- * `process.env` elsewhere. Values are read on every call (no caching) so tests
- * and long-lived processes observe changes.
+ * The QUESTIONER_* runtime flags are retired with the card generators
+ * (conversational-questions plan); park-path routing is always on. What
+ * remains are the historical budget constants still referenced by the
+ * questions-table adapter until its surface drops.
  */
-export declare const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
-export declare const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;
 /**
  * Refinement questions a single intent may generate per rolling window.
  *
@@ -40,18 +25,3 @@ export declare const INTENT_QUESTION_DAILY_CAP_DEFAULT = 2;
  * have granted the second burst a full fresh allowance.
  */
 export declare const INTENT_QUESTION_DAILY_WINDOW_HOURS = 24;
-/** Master switch: is any background question generation enabled? */
-export declare function isQuestionerEnabled(): boolean;
-/** Advisory uptake interlock. Flag-off by default and subordinate to the master switch. */
-export declare function isUptakeGuardEnabled(): boolean;
-/** Authority threshold below which hosts may generate uptake questions. */
-export declare function uptakeAuthorityThreshold(): number;
-/** Wait budget for the blocking ask_user_question chat tool. */
-export declare function chatQuestionWaitTimeoutMs(): number;
-/**
- * Per-intent refinement budget over {@link INTENT_QUESTION_DAILY_WINDOW_HOURS}.
- *
- * Zero is a meaningful setting — it disables background refinement entirely
- * without touching the master switch — so this does not reuse `positiveIntEnv`.
- */
-export declare function intentQuestionDailyCap(): number;

package/dist/questions/question.env.js

@@ -1,26 +1,11 @@
 /**
- * questions/question.env — centralized question-generation env accessors.
+ * questions/question.env — leftover question env constants.
  *
- * Naming scheme (one prefix, hierarchical):
- *
- *   QUESTIONER_ENABLED                  master switch — QuestionerQueue worker +
- *                                       enqueue closures at every composition site.
- *   QUESTIONER_UPTAKE_ENABLED           per-surface switch — advisory pre-accept uptake
- *                                       interlock. Requires the master switch.
- *   QUESTIONER_UPTAKE_AUTHORITY_THRESHOLD
- *                                       authority threshold (0-100, default 70).
- *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
- *                                       tool waits for an inline answer (default 4 min).
- *   QUESTIONER_INTENT_DAILY_CAP         refinement questions one intent may generate
- *                                       per rolling 24h, recovery + pool combined
- *                                       (default 2; 0 disables refinement).
- *
- * All reads go through this module — do not read these variables via
- * `process.env` elsewhere. Values are read on every call (no caching) so tests
- * and long-lived processes observe changes.
+ * The QUESTIONER_* runtime flags are retired with the card generators
+ * (conversational-questions plan); park-path routing is always on. What
+ * remains are the historical budget constants still referenced by the
+ * questions-table adapter until its surface drops.
  */
-export const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
-export const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;
 /**
  * Refinement questions a single intent may generate per rolling window.
  *
@@ -40,53 +25,3 @@ export const INTENT_QUESTION_DAILY_CAP_DEFAULT = 2;
  * have granted the second burst a full fresh allowance.
  */
 export const INTENT_QUESTION_DAILY_WINDOW_HOURS = 24;
-/**
- * Parse a positive integer env var, clamped to the safe-integer range so a
- * malformed env value cannot crash `AbortSignal.timeout` (which throws on
- * values outside `[0, MAX_SAFE_INTEGER]`).
- */
-function positiveIntEnv(name, fallback) {
-    const raw = process.env[name];
-    if (!raw)
-        return fallback;
-    const parsed = Number.parseInt(raw, 10);
-    if (!Number.isFinite(parsed) || parsed <= 0 || parsed > Number.MAX_SAFE_INTEGER)
-        return fallback;
-    return parsed;
-}
-/** Master switch: is any background question generation enabled? */
-export function isQuestionerEnabled() {
-    return process.env.QUESTIONER_ENABLED === "true";
-}
-/** Advisory uptake interlock. Flag-off by default and subordinate to the master switch. */
-export function isUptakeGuardEnabled() {
-    return isQuestionerEnabled() && process.env.QUESTIONER_UPTAKE_ENABLED === "true";
-}
-/** Authority threshold below which hosts may generate uptake questions. */
-export function uptakeAuthorityThreshold() {
-    const raw = process.env.QUESTIONER_UPTAKE_AUTHORITY_THRESHOLD;
-    if (!raw?.trim())
-        return UPTAKE_AUTHORITY_THRESHOLD_DEFAULT;
-    if (!/^-?\d+$/.test(raw.trim()))
-        return UPTAKE_AUTHORITY_THRESHOLD_DEFAULT;
-    const parsed = Number.parseInt(raw, 10);
-    return Math.min(100, Math.max(0, parsed));
-}
-/** Wait budget for the blocking ask_user_question chat tool. */
-export function chatQuestionWaitTimeoutMs() {
-    return positiveIntEnv("QUESTIONER_CHAT_WAIT_TIMEOUT_MS", CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT);
-}
-/**
- * Per-intent refinement budget over {@link INTENT_QUESTION_DAILY_WINDOW_HOURS}.
- *
- * Zero is a meaningful setting — it disables background refinement entirely
- * without touching the master switch — so this does not reuse `positiveIntEnv`.
- */
-export function intentQuestionDailyCap() {
-    const raw = process.env.QUESTIONER_INTENT_DAILY_CAP;
-    if (!raw?.trim())
-        return INTENT_QUESTION_DAILY_CAP_DEFAULT;
-    if (!/^\d+$/.test(raw.trim()))
-        return INTENT_QUESTION_DAILY_CAP_DEFAULT;
-    return Number.parseInt(raw, 10);
-}

package/dist/questions/question.input.d.ts

@@ -1,37 +1,20 @@
 /**
- * questions/question.input — QuestionerAgent input envelope.
+ * questions/question.input — park-path question payloads.
  *
- * Defines per-mode context types (IntentContext, NegotiationContext, …),
- * the discriminated QuestionerInput union, and the runtime validation guard
- * `isValidQuestionerInputContract`.
- *
- * Lives in the application layer (not domain) because `isValidQuestionerInputContract`
- * consumes the negotiation question-safety port
- * (`capabilities/negotiation.questions.facade`) to enforce privacy invariants
- * on counterparty hints and indexContext labels.
- *
- * Foreground and ambient adapter entry points inject a `QuestionerEnqueueFn`
- * (defined here as a port alias) to schedule async generation without
- * importing the queue implementation.
+ * The QuestionerAgent and its per-mode generation envelope are retired
+ * (conversational-questions plan, "Retirements"). What survives is the
+ * payload the negotiation graph hands the composition root when a
+ * negotiation parks needing its client's input: the two park families
+ * (`negotiation_inflight`/`inflight_consultation` mid-flight consults and
+ * `negotiation`/`stalled_followup` post-stall parks). The composition root
+ * routes them to the question-message regeneration queue keyed on the parked
+ * side's `(recipientUserId, recipientIntentId)`; the parked negotiation is
+ * the durable record and the DM message is its rendering.
  */
 import type { ToolScopeType } from "../shared/agent/tool.scope.js";
-import type { NegotiationQuestionCandidate, QuestionMode, QuestionPoolDiscriminator } from "./question.schema.js";
+import type { NegotiationQuestionCandidate } from "./question.schema.js";
 import type { NegotiationConsultationReason } from "../negotiations/negotiation.module.js";
-/** 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;
-}
-/** Shared context fields for negotiation-mode questions. */
+/** Shared context fields for negotiation park payloads. */
 interface NegotiationContextBase {
     negotiationId: string;
     /** Privacy-reviewed generic description; never raw counterparty identity/profile. */
@@ -48,20 +31,10 @@ export interface PostStallNegotiationContext extends NegotiationContextBase {
     /** 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 supplies only a closed category; the QuestionerAgent receives
- * server-owned fixed copy and never agent-authored instruction text.
- * Distinct from {@link NegotiationContext}, which covers post-stall questions.
+ * OWN client a question before continuing (the `ask_user` action, P3.2).
+ * The negotiator supplies only a closed category.
  */
 export interface NegotiationInflightContext {
     negotiationId: string;
@@ -69,108 +42,47 @@ export interface NegotiationInflightContext {
     counterpartyHint: string;
     /** Community / index context the negotiation runs in. */
     indexContext: string;
-    /** Closed server-owned category selecting fixed Questioner copy. */
+    /** Closed server-owned category selecting the consultation reason. */
     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 = IntentContext | RecoveryIntentContext | NegotiationContext | NegotiationInflightContext | ChatContext | PoolDiscoveryContext;
-/**
- * Payload shape accepted by the questionerEnqueue callback. Covers all
- * question modes — the composition root bridges this to the concrete
- * QuestionerQueue.
+ * Payload shape accepted by the questionerEnqueue callback: exactly the two
+ * park families. The composition root bridges this to the question-message
+ * regeneration queue.
  */
 export type QuestionerEnqueuePayload = QuestionerInput;
 /**
- * Callback signature for async question generation enqueue.
+ * Callback signature for the park-path enqueue.
  *
- * Ambient adapter port: recovery, pool, uptake, inflight, and push generation
- * each inject this callback from the composition root; they never import the
- * queue implementation directly.
+ * Ambient adapter port: the negotiation graph and the external-consultation
+ * pause path inject this callback from the composition root; they never
+ * import the queue implementation directly.
  */
 export type QuestionerEnqueueFn = (input: QuestionerEnqueuePayload) => Promise<void>;
-/** Top-level input envelope for QuestionerAgent.invoke(). */
+/** Shared envelope fields for both park families. */
 interface QuestionerInputBase {
-    /** Selects the preset (system prompt + builder). */
-    mode: QuestionMode;
-    /** User the questions are generated for. */
+    /** User whose input is required (the parked side). */
     userId: string;
-    /** Entity type that triggered this (e.g. "opportunity", "intent", "profile"). */
+    /** Entity type that triggered this (always "opportunity" for park payloads). */
     sourceType: string;
     /** ID of the triggering entity. */
     sourceId: string;
-    /** Scoped question context. Network scopes persist as QuestionActor.networkId. */
+    /** Scoped context carried through from the triggering surface. */
     scopeType?: ToolScopeType;
-    /** Scoped question id. When scopeType is `network`, this is the actor networkId. */
+    /** Scoped id. When scopeType is `network`, this is the network id. */
     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.
-     */
+    /** Intent that triggered the run, when the producer knows it. */
     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.
+     * Candidate exact binding. `recipientUserId`/`recipientIntentId` name the
+     * parked side — the user whose input is required and the signal whose DM
+     * carries the question-message.
      */
-    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>;
+    negotiation: NegotiationQuestionCandidate;
 }
-/** Ordinary post-stall generation is task-backed and uses only the ordinary preset. */
+/** Post-stall park payload, task-backed. */
 export interface PostStallQuestionerInput extends QuestionerInputBase {
     mode: "negotiation";
     purpose: "stalled_followup";
@@ -180,7 +92,7 @@ export interface PostStallQuestionerInput extends QuestionerInputBase {
     };
     context: PostStallNegotiationContext;
 }
-/** Mid-negotiation consultation is task-backed and uses only structured ask_user fields. */
+/** Mid-negotiation consultation park payload, task-backed. */
 export interface InflightQuestionerInput extends QuestionerInputBase {
     mode: "negotiation_inflight";
     purpose: "inflight_consultation";
@@ -190,27 +102,6 @@ export interface InflightQuestionerInput extends QuestionerInputBase {
     };
     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;
+/** Park-path payload union, discriminated by mode + internal purpose. */
+export type QuestionerInput = PostStallQuestionerInput | InflightQuestionerInput;
 export {};

package/dist/questions/question.input.js

@@ -1,56 +1 @@
-import { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, NEGOTIATION_QUESTION_GENERIC_UPTAKE_ACTIVITY } from "../negotiations/negotiation.module.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
-            && (context.consultationPolicyReason === 'unresolved_owner_constraint'
-                || context.consultationPolicyReason === 'consequential_disclosure_permission'
-                || context.consultationPolicyReason === 'repeated_non_convergence'
-                || context.consultationPolicyReason === 'insufficient_commitment_authority');
-    }
-    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;
-}
+export {};