@indexnetwork/protocol 6.7.1 → 6.9.0-rc.396.1

package/dist/opportunity/opportunity.state.d.ts

@@ -1,5 +1,4 @@
-import type { Id } from '../shared/interfaces/database.interface.js';
-import type { OpportunityStatus, Opportunity } from '../shared/interfaces/database.interface.js';
+import type { Id, NegotiationContinuationExecution, NegotiationContinuationReceipt, OpportunityStatus, Opportunity } from '../shared/interfaces/database.interface.js';
 import type { Lens } from '../shared/interfaces/embedder.interface.js';
 import type { EvaluatorEntity } from './opportunity.evaluator.js';
 import type { DebugMetaAgent } from '../chat/chat-streaming.types.js';
@@ -147,6 +146,8 @@ export declare function resolveInitialStatus(trigger: OpportunityTrigger, explic
  * Options passed to the graph
  */
 export interface OpportunityGraphOptions {
+    /** Exact durable ask_user settlement being resumed; internal queue path only. */
+    negotiationContinuation?: NegotiationContinuationExecution;
     /** Initial status for created opportunities (default: 'pending') */
     initialStatus?: OpportunityStatus;
     /** Minimum score threshold (default: 50) */
@@ -346,6 +347,8 @@ export declare const OpportunityGraphState: import("@langchain/langgraph").Annot
     }[]>, unknown>;
     /** Typed persist-node counts used by queue telemetry. */
     persistenceOutcome: import("@langchain/langgraph").BaseChannel<OpportunityPersistenceOutcome | undefined, OpportunityPersistenceOutcome | import("@langchain/langgraph").OverwriteValue<OpportunityPersistenceOutcome | undefined> | undefined, unknown>;
+    /** Positive exact-successor receipt for a fenced continuation. */
+    negotiationContinuationReceipt: import("@langchain/langgraph").BaseChannel<NegotiationContinuationReceipt | undefined, NegotiationContinuationReceipt | import("@langchain/langgraph").OverwriteValue<NegotiationContinuationReceipt | undefined> | undefined, unknown>;
     /** Error message if any step fails */
     error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
     /** Output for read mode: enriched list of opportunities. */

package/dist/opportunity/opportunity.state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opportunity.state.d.ts","sourceRoot":"/","sources":["opportunity/opportunity.state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"opportunity.state.d.ts","sourceRoot":"/","sources":["opportunity/opportunity.state.ts"],"names":[],"mappings":"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"}

package/dist/opportunity/opportunity.state.js

@@ -253,6 +253,11 @@ export const OpportunityGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => undefined,
     }),
+    /** Positive exact-successor receipt for a fenced continuation. */
+    negotiationContinuationReceipt: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
     /** Error message if any step fails */
     error: Annotation({
         reducer: (curr, next) => next,

package/dist/opportunity/opportunity.state.js.map

@@ -1 +1 @@
-{"version":3,"file":"opportunity.state.js","sourceRoot":"/","sources":["opportunity/opportunity.state.ts"],"names":[],"mappings":"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","sourcesContent":["import { Annotation } from \"@langchain/langgraph\";\nimport type { Id } from '../shared/interfaces/database.interface.js';\nimport type { OpportunityStatus, Opportunity } from '../shared/interfaces/database.interface.js';\nimport type { Lens } from '../shared/interfaces/embedder.interface.js';\nimport type { EvaluatorEntity } from './opportunity.evaluator.js';\nimport type { DebugMetaAgent } from '../chat/chat-streaming.types.js';\nimport type { OpportunityEvidence } from '../shared/schemas/network-assignment.schema.js';\nimport type { DiscoveryNegotiation, DiscoverySummary } from \"../shared/schemas/discovery-question.schema.js\";\n\n/**\n * Opportunity Graph State (Linear Multi-Step Workflow)\n *\n * Flow: Prep → Scope → Discovery → Evaluation → Ranking → Persist → END\n *\n * Following the intent graph pattern with Annotation-based state management.\n */\n\n/** Asker's profile shape (identity + context). Used by sourceProfile annotation. */\nexport interface SourceProfileData {\n  identity?: { name?: string; bio?: string; location?: string };\n  context?: string;\n}\n\n/**\n * Indexed intent with hyde document (from prep node)\n */\nexport interface IndexedIntent {\n  intentId: Id<'intents'>;\n  payload: string;\n  summary?: string;\n  hydeDocumentId?: string;\n  hydeEmbedding?: number[];\n  indexes: Id<'networks'>[];\n}\n\n/**\n * Target index for search (from scope node)\n */\nexport interface TargetNetwork {\n  networkId: Id<'networks'>;\n  title: string;\n  memberCount: number;\n}\n\n/**\n * Candidate match from discovery (semantic search).\n */\nexport interface CandidateMatch {\n  candidateUserId: Id<'users'>;\n  candidateIntentId?: Id<'intents'>;\n  /** Source premise that produced this candidate (set when discoverySource is 'premise-similarity'). */\n  sourcePremiseId?: Id<'premises'>;\n  /** Candidate premise that matched this candidate (set for premise-based matches). */\n  candidatePremiseId?: Id<'premises'>;\n  /** Source context that produced this candidate (set when discoverySource is 'context-to-intent'). */\n  sourceContextId?: string;\n  networkId: Id<'networks'>;\n  similarity: number;\n  /** Free-text lens label that produced this match. */\n  lens: string;\n  candidatePayload: string;\n  candidateSummary?: string;\n  /** How this candidate was found: 'query' (HyDE from search text), 'premise-similarity', or 'context-to-intent'. */\n  discoverySource?: 'query' | 'premise-similarity' | 'context-to-intent';\n  /** Which discovery strategies found this candidate (set by mergeStrategyCandidates). */\n  matchedStrategies?: string[];\n  /** Typed evidence that explains why this candidate entered evaluation. */\n  evidence?: OpportunityEvidence[];\n}\n\n/**\n * Evaluated candidate with LLM scoring (legacy; used when evaluator returns source/candidate pair).\n * candidateIntentId is set for intent matches; omitted for profile-only matches.\n */\nexport interface EvaluatedCandidate {\n  sourceUserId: Id<'users'>;\n  candidateUserId: Id<'users'>;\n  sourceIntentId?: Id<'intents'>;\n  candidateIntentId?: Id<'intents'>;\n  networkId: Id<'networks'>;\n  score: number; // 0-100\n  reasoning: string; // Third-party analytical explanation of the match (for LLM agents)\n  valencyRole: 'Agent' | 'Patient' | 'Peer';\n  /** Free-text lens label that produced this match. */\n  lens: string;\n}\n\n/**\n * Actor in an evaluated opportunity (from entity-bundle evaluator).\n * networkId is filled from the entity bundle in the graph, not by the evaluator.\n */\nexport interface EvaluatedOpportunityActor {\n  userId: Id<'users'>;\n  role: 'agent' | 'patient' | 'peer';\n  intentId?: Id<'intents'>;\n  networkId: Id<'networks'>;\n}\n\n/**\n * Evaluated opportunity with multi-actor output (entity-bundle evaluator).\n */\nexport interface EvaluatedOpportunity {\n  actors: EvaluatedOpportunityActor[];\n  score: number;\n  reasoning: string;\n  evidence?: OpportunityEvidence[];\n}\n\nexport interface OpportunityPersistenceOutcome {\n  evaluatedCount: number;\n  createdCount: number;\n  reactivatedCount: number;\n  sameTriggerDuplicateSuppressions: number;\n  pairActiveNegotiationSuppressions: number;\n  crossTriggerAllowedCount: number;\n  finalAtomicConflictCount: number;\n}\n\n/**\n * Which flow triggered this graph invocation. Determines initial persist status,\n * park-window timeout, streaming behavior, and whether AbortSignal is honored.\n *\n * - 'ambient' (default): queue-driven. Persists at the trigger default of\n *   `pending` unless `options.initialStatus` overrides (the queue worker\n *   passes `'latent'`, chat-bound ambient discovery passes `'draft'`). 5-min\n *   park window, no streaming, ignores abort.\n * - 'orchestrator': chat-driven. Persists at the trigger default of\n *   `negotiating` unless `options.initialStatus` overrides. 60s park window,\n *   streams `opportunity_draft_ready` events, honors abort.\n *\n * See {@link resolveInitialStatus} for the exact fallback used when\n * `options.initialStatus` is undefined.\n */\nexport type OpportunityTrigger = 'ambient' | 'orchestrator';\n\n/**\n * Resolves the initial status for opportunities created in the persist node.\n *\n * Explicit `options.initialStatus` always wins (callers like the chat tool or\n * maintenance scripts override per-call). When the caller leaves it\n * undefined, the trigger drives the default:\n * - 'orchestrator' → 'negotiating' (chat-driven; negotiations run before the\n *   user sees a draft card).\n * - 'ambient' (or any other trigger) → 'pending' (long-standing default for\n *   queue- and intent-driven discovery).\n *\n * Lives here rather than in opportunity.graph.ts so unit tests can exercise\n * it without pulling in the full graph (and the evaluator's LLM requirements).\n *\n * @param trigger - The graph invocation's trigger\n * @param explicit - Caller-supplied initial status from options.initialStatus\n */\nexport function resolveInitialStatus(\n  trigger: OpportunityTrigger,\n  explicit: OpportunityStatus | undefined,\n): OpportunityStatus {\n  if (explicit !== undefined) return explicit;\n  return trigger === 'orchestrator' ? 'negotiating' : 'pending';\n}\n\n/**\n * Options passed to the graph\n */\nexport interface OpportunityGraphOptions {\n  /** Initial status for created opportunities (default: 'pending') */\n  initialStatus?: OpportunityStatus;\n  /** Minimum score threshold (default: 50) */\n  minScore?: number;\n  /** Maximum opportunities to return (default: 20) */\n  limit?: number;\n  /** Pre-inferred lenses (if not provided, lens inference runs automatically in HyDE graph) */\n  lenses?: Lens[];\n  /** User's search query for HyDE generation */\n  hydeDescription?: string;\n  /** Existing opportunities summary for evaluator deduplication */\n  existingOpportunities?: string;\n  /** Chat session ID for draft opportunities; stored as context.conversationId for visibility filtering. */\n  conversationId?: string;\n  /**\n   * MCP-only: cap the negotiate-phase wall-clock at this many milliseconds.\n   * When set, `negotiateNode` races `negotiateCandidates(...)` against a timer;\n   * if the timer wins, the node returns early with a `timed_out` trace and the\n   * unawaited negotiation chains finalize each opp's DB status in the\n   * background. Set to 20_000 by the MCP `discover_opportunities` handler.\n   * Chat, ambient queue, and all other callers omit this — existing behavior.\n   */\n  negotiateTimeoutMs?: number;\n}\n\n/**\n * Opportunity Graph State Annotation\n */\nexport const OpportunityGraphState = Annotation.Root({\n  // ─── Input Fields (Required) ───\n  userId: Annotation<Id<'users'>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => '' as Id<'users'>,\n  }),\n\n  searchQuery: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  networkId: Annotation<Id<'networks'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /**\n   * Optional set of indexes discovery may search within (e.g. a network-scoped\n   * agent's reachable networks: the bound network plus the user's personal network).\n   * The scope node intersects this with the user's actual memberships. Ignored\n   * when `networkId` is set (single-network override). When unset, discovery\n   * spans all of the user's networks.\n   */\n  indexScope: Annotation<Id<'networks'>[] | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Optional intent to use as discovery source and for triggeredBy. When set, used for search text (if query empty) and persist. */\n  triggerIntentId: Annotation<Id<'intents'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Optional: restrict discovery to this specific user ID only (direct connection). */\n  targetUserId: Annotation<Id<'users'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Optional: discover on behalf of this user (introducer flow). When set, prep/eval use this user's profile/intents; userId becomes the introducer. */\n  onBehalfOfUserId: Annotation<Id<'users'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  options: Annotation<OpportunityGraphOptions>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({}),\n  }),\n\n  /**\n   * Which flow triggered this graph invocation. See {@link OpportunityTrigger}\n   * for the exact branch behavior and {@link resolveInitialStatus} for the\n   * persist default when `options.initialStatus` is unset.\n   *\n   * - 'ambient' (default): queue-driven, persist default `pending`, 5-min\n   *   park window, no streaming, ignores abort.\n   * - 'orchestrator': chat-driven, persist default `negotiating`, 60s park\n   *   window, streams `opportunity_draft_ready` events, honors abort.\n   */\n  trigger: Annotation<OpportunityTrigger>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'ambient',\n  }),\n\n  /**\n   * Accepted opportunities the persist node discovered between the discoverer\n   * and a candidate actor (same pair, status='accepted'). The orchestrator\n   * branch populates this so the discover_opportunities tool (Task 7) can tell\n   * the LLM \"these pairs are already connected, surface the existing chat\n   * rather than creating a new draft\". Always empty for the ambient trigger.\n   *\n   * Left intentionally minimal — conversationId/URL resolution happens at\n   * Start Chat time (Task 8), not here.\n   */\n  dedupAlreadyAccepted: Annotation<Array<{\n    opportunityId: string;\n    counterpartyUserId: string;\n  }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /**\n   * Operation mode controls graph flow:\n   * - 'create': Existing discover pipeline (Prep → Scope → Discovery → Evaluation → Ranking → Persist)\n   * - 'create_introduction': Introduction path (validation → evaluation → persist) for chat-driven intros\n   * - 'continue_discovery': Pagination path (Prep → Evaluation → Ranking → Persist) using pre-loaded candidates\n   * - 'read': List opportunities filtered by userId and optionally networkId (fast path)\n   * - 'update': Change opportunity status (accept, reject, etc.)\n   * - 'delete': Expire/archive an opportunity\n   * - 'send': Promote latent opportunity to pending + queue notification\n   * - 'negotiate_existing': Load an existing opportunity by opportunityId and run bilateral negotiation.\n   *   Used after introducer approval to trigger the normal negotiation flow.\n   * - 'approve_introduction': Mark the caller as having approved a latent introducer opportunity,\n   *   then enqueue a negotiate_existing job for that opportunity.\n   *\n   * Defaults to 'create' for backward compatibility.\n   */\n  operationMode: Annotation<'create' | 'create_introduction' | 'continue_discovery' | 'read' | 'update' | 'delete' | 'send' | 'negotiate_existing' | 'approve_introduction'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'create' as const,\n  }),\n\n  /** Introduction mode: pre-gathered entities (profiles + intents per party). */\n  introductionEntities: Annotation<EvaluatorEntity[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Introduction mode: optional hint from the introducer. */\n  introductionHint: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** When set (e.g. chat scope), networkId must match this. */\n  requiredNetworkId: Annotation<Id<'networks'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Set by intro_evaluation; used by persist to build manual detection and introducer actor. */\n  introductionContext: Annotation<{ createdByName?: string } | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Target opportunity ID for update/delete/send modes. */\n  opportunityId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** New status for update mode (e.g. 'accepted', 'rejected'). */\n  newStatus: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  // ─── Intermediate Fields (Accumulated) ───\n\n  /** User's indexed intents with hyde documents (from prep) */\n  indexedIntents: Annotation<IndexedIntent[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** User's network memberships (from prep) */\n  userNetworks: Annotation<Id<'networks'>[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Target indexes to search within (from scope) */\n  targetNetworks: Annotation<TargetNetwork[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Per-index relevancy scores for dedup tie-breaking. Background path: from intent_indexes. Chat path: transient from IntentIndexer. */\n  indexRelevancyScores: Annotation<Record<string, number>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({}),\n  }),\n\n  /** Whether discovery used intent (path A) or user context (path B/C). Used by persist for triggeredBy. In-memory routing state only; never persisted. */\n  discoverySource: Annotation<'intent' | 'context'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'intent',\n  }),\n\n  /** Resolved intent ID used for this discovery run (when discoverySource is 'intent'). Set by intent-resolution. */\n  resolvedTriggerIntentId: Annotation<Id<'intents'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Asker's profile (from prep). Used for profile-as-source discovery and evaluation. */\n  sourceProfile: Annotation<SourceProfileData | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /** User's active premises with embeddings (from prep). Used for premise-to-premise discovery path D. */\n  sourcePremises: Annotation<Array<{ premiseId: Id<'premises'>; embedding: number[] }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** User context embeddings per network (from prep). Used for context-to-intent discovery. */\n  sourceContexts: Annotation<Array<{ contextId: string; networkId: Id<'networks'>; text: string; embedding: number[] }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Resolved intent is in at least one target index (path A vs C). */\n  resolvedIntentInIndex: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n\n  /** Create-intent signal: when true, tool should return createIntentSuggested so agent can auto-call create_intent. */\n  createIntentSuggested: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n\n  /** Suggested description for create_intent when createIntentSuggested is true. */\n  suggestedIntentDescription: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** HyDE embeddings per lens label (from discovery) */\n  hydeEmbeddings: Annotation<Record<string, number[]>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({}),\n  }),\n\n  /** Candidate matches from semantic search (from discovery) */\n  candidates: Annotation<CandidateMatch[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Candidates not yet evaluated (for pagination -- cached in Redis by caller). */\n  remainingCandidates: Annotation<CandidateMatch[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Discovery session ID for pagination (maps to Redis cache key). */\n  discoveryId: Annotation<string | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /** Evaluated candidates with scores (from evaluation; legacy) */\n  evaluatedCandidates: Annotation<EvaluatedCandidate[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Evaluated opportunities with actors (from entity-bundle evaluator) */\n  evaluatedOpportunities: Annotation<EvaluatedOpportunity[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  // ─── Output Fields (Overwrite per turn) ───\n\n  /** Final ranked and persisted opportunities */\n  opportunities: Annotation<Opportunity[]>({\n    reducer: (curr, next) => next,\n    default: () => [],\n  }),\n\n  /** Discovery path: pairs skipped because an opportunity already exists between viewer and candidate (no duplicate created). */\n  existingBetweenActors: Annotation<Array<{\n    candidateUserId: Id<'users'>;\n    networkId: Id<'networks'>;\n    existingOpportunityId?: Id<'opportunities'>;\n    existingStatus?: OpportunityStatus;\n    reason?: 'same_trigger_recent_duplicate' | 'pair_active_negotiation' | 'final_atomic_conflict';\n    existingTriggerIntentId?: string;\n  }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Typed persist-node counts used by queue telemetry. */\n  persistenceOutcome: Annotation<OpportunityPersistenceOutcome | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Error message if any step fails */\n  error: Annotation<string | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  /** Output for read mode: enriched list of opportunities. */\n  readResult: Annotation<{\n    count: number;\n    message?: string;\n    opportunities: Array<{\n      id: string;\n      indexName: string;\n      connectedWith: string[];\n      suggestedBy: string | null;\n      reasoning: string;\n      status: string;\n      category: string;\n      confidence: number | null;\n      source: string | null;\n    }>;\n  } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  /** Output for update/delete/send modes. */\n  mutationResult: Annotation<{\n    success: boolean;\n    message?: string;\n    opportunityId?: string;\n    notified?: string[];\n    conversationId?: string;\n    error?: string;\n  } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  // ─── Trace Output ───\n\n  /**\n   * Accumulated trace entries from each graph node.\n   * Used for observability: surfaces internal processing steps (search query, HyDE strategies,\n   * candidates found, evaluation results) to the frontend.\n   */\n  trace: Annotation<Array<{ node: string; detail?: string; data?: Record<string, unknown> }>>({\n    reducer: (curr, next) => [...curr, ...(next || [])],\n    default: () => [],\n  }),\n\n  /** Timing records for each agent invocation within this graph run. */\n  agentTimings: Annotation<DebugMetaAgent[]>({\n    reducer: (acc, val) => [...acc, ...val],\n    default: () => [],\n  }),\n\n  /**\n   * Per-candidate negotiation records captured by `negotiateNode`. Populated\n   * regardless of accept/reject so the question generator sees a complete\n   * picture. Populated for ALL triggers (ambient + orchestrator) since the\n   * negotiate node's `onCandidateResolved` hook is unconditional; only the\n   * orchestrator streaming side-effects (opportunity_draft_ready emission)\n   * are trigger-gated. Empty when the negotiate node was skipped (no\n   * opportunities to negotiate).\n   */\n  discoveryNegotiations: Annotation<DiscoveryNegotiation[]>({\n    reducer: (curr, next) => [...curr, ...(next || [])],\n    default: () => [],\n  }),\n\n  /** Aggregate counters across `discoveryNegotiations`. Built in the negotiate node. */\n  discoverySummary: Annotation<DiscoverySummary | null>({\n    reducer: (_curr, next) => next ?? null,\n    default: () => null,\n  }),\n});\n"]}
+{"version":3,"file":"opportunity.state.js","sourceRoot":"/","sources":["opportunity/opportunity.state.ts"],"names":[],"mappings":"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","sourcesContent":["import { Annotation } from \"@langchain/langgraph\";\nimport type { Id, NegotiationContinuationExecution, NegotiationContinuationReceipt, OpportunityStatus, Opportunity } from '../shared/interfaces/database.interface.js';\nimport type { Lens } from '../shared/interfaces/embedder.interface.js';\nimport type { EvaluatorEntity } from './opportunity.evaluator.js';\nimport type { DebugMetaAgent } from '../chat/chat-streaming.types.js';\nimport type { OpportunityEvidence } from '../shared/schemas/network-assignment.schema.js';\nimport type { DiscoveryNegotiation, DiscoverySummary } from \"../shared/schemas/discovery-question.schema.js\";\n\n/**\n * Opportunity Graph State (Linear Multi-Step Workflow)\n *\n * Flow: Prep → Scope → Discovery → Evaluation → Ranking → Persist → END\n *\n * Following the intent graph pattern with Annotation-based state management.\n */\n\n/** Asker's profile shape (identity + context). Used by sourceProfile annotation. */\nexport interface SourceProfileData {\n  identity?: { name?: string; bio?: string; location?: string };\n  context?: string;\n}\n\n/**\n * Indexed intent with hyde document (from prep node)\n */\nexport interface IndexedIntent {\n  intentId: Id<'intents'>;\n  payload: string;\n  summary?: string;\n  hydeDocumentId?: string;\n  hydeEmbedding?: number[];\n  indexes: Id<'networks'>[];\n}\n\n/**\n * Target index for search (from scope node)\n */\nexport interface TargetNetwork {\n  networkId: Id<'networks'>;\n  title: string;\n  memberCount: number;\n}\n\n/**\n * Candidate match from discovery (semantic search).\n */\nexport interface CandidateMatch {\n  candidateUserId: Id<'users'>;\n  candidateIntentId?: Id<'intents'>;\n  /** Source premise that produced this candidate (set when discoverySource is 'premise-similarity'). */\n  sourcePremiseId?: Id<'premises'>;\n  /** Candidate premise that matched this candidate (set for premise-based matches). */\n  candidatePremiseId?: Id<'premises'>;\n  /** Source context that produced this candidate (set when discoverySource is 'context-to-intent'). */\n  sourceContextId?: string;\n  networkId: Id<'networks'>;\n  similarity: number;\n  /** Free-text lens label that produced this match. */\n  lens: string;\n  candidatePayload: string;\n  candidateSummary?: string;\n  /** How this candidate was found: 'query' (HyDE from search text), 'premise-similarity', or 'context-to-intent'. */\n  discoverySource?: 'query' | 'premise-similarity' | 'context-to-intent';\n  /** Which discovery strategies found this candidate (set by mergeStrategyCandidates). */\n  matchedStrategies?: string[];\n  /** Typed evidence that explains why this candidate entered evaluation. */\n  evidence?: OpportunityEvidence[];\n}\n\n/**\n * Evaluated candidate with LLM scoring (legacy; used when evaluator returns source/candidate pair).\n * candidateIntentId is set for intent matches; omitted for profile-only matches.\n */\nexport interface EvaluatedCandidate {\n  sourceUserId: Id<'users'>;\n  candidateUserId: Id<'users'>;\n  sourceIntentId?: Id<'intents'>;\n  candidateIntentId?: Id<'intents'>;\n  networkId: Id<'networks'>;\n  score: number; // 0-100\n  reasoning: string; // Third-party analytical explanation of the match (for LLM agents)\n  valencyRole: 'Agent' | 'Patient' | 'Peer';\n  /** Free-text lens label that produced this match. */\n  lens: string;\n}\n\n/**\n * Actor in an evaluated opportunity (from entity-bundle evaluator).\n * networkId is filled from the entity bundle in the graph, not by the evaluator.\n */\nexport interface EvaluatedOpportunityActor {\n  userId: Id<'users'>;\n  role: 'agent' | 'patient' | 'peer';\n  intentId?: Id<'intents'>;\n  networkId: Id<'networks'>;\n}\n\n/**\n * Evaluated opportunity with multi-actor output (entity-bundle evaluator).\n */\nexport interface EvaluatedOpportunity {\n  actors: EvaluatedOpportunityActor[];\n  score: number;\n  reasoning: string;\n  evidence?: OpportunityEvidence[];\n}\n\nexport interface OpportunityPersistenceOutcome {\n  evaluatedCount: number;\n  createdCount: number;\n  reactivatedCount: number;\n  sameTriggerDuplicateSuppressions: number;\n  pairActiveNegotiationSuppressions: number;\n  crossTriggerAllowedCount: number;\n  finalAtomicConflictCount: number;\n}\n\n/**\n * Which flow triggered this graph invocation. Determines initial persist status,\n * park-window timeout, streaming behavior, and whether AbortSignal is honored.\n *\n * - 'ambient' (default): queue-driven. Persists at the trigger default of\n *   `pending` unless `options.initialStatus` overrides (the queue worker\n *   passes `'latent'`, chat-bound ambient discovery passes `'draft'`). 5-min\n *   park window, no streaming, ignores abort.\n * - 'orchestrator': chat-driven. Persists at the trigger default of\n *   `negotiating` unless `options.initialStatus` overrides. 60s park window,\n *   streams `opportunity_draft_ready` events, honors abort.\n *\n * See {@link resolveInitialStatus} for the exact fallback used when\n * `options.initialStatus` is undefined.\n */\nexport type OpportunityTrigger = 'ambient' | 'orchestrator';\n\n/**\n * Resolves the initial status for opportunities created in the persist node.\n *\n * Explicit `options.initialStatus` always wins (callers like the chat tool or\n * maintenance scripts override per-call). When the caller leaves it\n * undefined, the trigger drives the default:\n * - 'orchestrator' → 'negotiating' (chat-driven; negotiations run before the\n *   user sees a draft card).\n * - 'ambient' (or any other trigger) → 'pending' (long-standing default for\n *   queue- and intent-driven discovery).\n *\n * Lives here rather than in opportunity.graph.ts so unit tests can exercise\n * it without pulling in the full graph (and the evaluator's LLM requirements).\n *\n * @param trigger - The graph invocation's trigger\n * @param explicit - Caller-supplied initial status from options.initialStatus\n */\nexport function resolveInitialStatus(\n  trigger: OpportunityTrigger,\n  explicit: OpportunityStatus | undefined,\n): OpportunityStatus {\n  if (explicit !== undefined) return explicit;\n  return trigger === 'orchestrator' ? 'negotiating' : 'pending';\n}\n\n/**\n * Options passed to the graph\n */\nexport interface OpportunityGraphOptions {\n  /** Exact durable ask_user settlement being resumed; internal queue path only. */\n  negotiationContinuation?: NegotiationContinuationExecution;\n  /** Initial status for created opportunities (default: 'pending') */\n  initialStatus?: OpportunityStatus;\n  /** Minimum score threshold (default: 50) */\n  minScore?: number;\n  /** Maximum opportunities to return (default: 20) */\n  limit?: number;\n  /** Pre-inferred lenses (if not provided, lens inference runs automatically in HyDE graph) */\n  lenses?: Lens[];\n  /** User's search query for HyDE generation */\n  hydeDescription?: string;\n  /** Existing opportunities summary for evaluator deduplication */\n  existingOpportunities?: string;\n  /** Chat session ID for draft opportunities; stored as context.conversationId for visibility filtering. */\n  conversationId?: string;\n  /**\n   * MCP-only: cap the negotiate-phase wall-clock at this many milliseconds.\n   * When set, `negotiateNode` races `negotiateCandidates(...)` against a timer;\n   * if the timer wins, the node returns early with a `timed_out` trace and the\n   * unawaited negotiation chains finalize each opp's DB status in the\n   * background. Set to 20_000 by the MCP `discover_opportunities` handler.\n   * Chat, ambient queue, and all other callers omit this — existing behavior.\n   */\n  negotiateTimeoutMs?: number;\n}\n\n/**\n * Opportunity Graph State Annotation\n */\nexport const OpportunityGraphState = Annotation.Root({\n  // ─── Input Fields (Required) ───\n  userId: Annotation<Id<'users'>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => '' as Id<'users'>,\n  }),\n\n  searchQuery: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  networkId: Annotation<Id<'networks'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /**\n   * Optional set of indexes discovery may search within (e.g. a network-scoped\n   * agent's reachable networks: the bound network plus the user's personal network).\n   * The scope node intersects this with the user's actual memberships. Ignored\n   * when `networkId` is set (single-network override). When unset, discovery\n   * spans all of the user's networks.\n   */\n  indexScope: Annotation<Id<'networks'>[] | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Optional intent to use as discovery source and for triggeredBy. When set, used for search text (if query empty) and persist. */\n  triggerIntentId: Annotation<Id<'intents'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Optional: restrict discovery to this specific user ID only (direct connection). */\n  targetUserId: Annotation<Id<'users'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Optional: discover on behalf of this user (introducer flow). When set, prep/eval use this user's profile/intents; userId becomes the introducer. */\n  onBehalfOfUserId: Annotation<Id<'users'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  options: Annotation<OpportunityGraphOptions>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({}),\n  }),\n\n  /**\n   * Which flow triggered this graph invocation. See {@link OpportunityTrigger}\n   * for the exact branch behavior and {@link resolveInitialStatus} for the\n   * persist default when `options.initialStatus` is unset.\n   *\n   * - 'ambient' (default): queue-driven, persist default `pending`, 5-min\n   *   park window, no streaming, ignores abort.\n   * - 'orchestrator': chat-driven, persist default `negotiating`, 60s park\n   *   window, streams `opportunity_draft_ready` events, honors abort.\n   */\n  trigger: Annotation<OpportunityTrigger>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'ambient',\n  }),\n\n  /**\n   * Accepted opportunities the persist node discovered between the discoverer\n   * and a candidate actor (same pair, status='accepted'). The orchestrator\n   * branch populates this so the discover_opportunities tool (Task 7) can tell\n   * the LLM \"these pairs are already connected, surface the existing chat\n   * rather than creating a new draft\". Always empty for the ambient trigger.\n   *\n   * Left intentionally minimal — conversationId/URL resolution happens at\n   * Start Chat time (Task 8), not here.\n   */\n  dedupAlreadyAccepted: Annotation<Array<{\n    opportunityId: string;\n    counterpartyUserId: string;\n  }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /**\n   * Operation mode controls graph flow:\n   * - 'create': Existing discover pipeline (Prep → Scope → Discovery → Evaluation → Ranking → Persist)\n   * - 'create_introduction': Introduction path (validation → evaluation → persist) for chat-driven intros\n   * - 'continue_discovery': Pagination path (Prep → Evaluation → Ranking → Persist) using pre-loaded candidates\n   * - 'read': List opportunities filtered by userId and optionally networkId (fast path)\n   * - 'update': Change opportunity status (accept, reject, etc.)\n   * - 'delete': Expire/archive an opportunity\n   * - 'send': Promote latent opportunity to pending + queue notification\n   * - 'negotiate_existing': Load an existing opportunity by opportunityId and run bilateral negotiation.\n   *   Used after introducer approval to trigger the normal negotiation flow.\n   * - 'approve_introduction': Mark the caller as having approved a latent introducer opportunity,\n   *   then enqueue a negotiate_existing job for that opportunity.\n   *\n   * Defaults to 'create' for backward compatibility.\n   */\n  operationMode: Annotation<'create' | 'create_introduction' | 'continue_discovery' | 'read' | 'update' | 'delete' | 'send' | 'negotiate_existing' | 'approve_introduction'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'create' as const,\n  }),\n\n  /** Introduction mode: pre-gathered entities (profiles + intents per party). */\n  introductionEntities: Annotation<EvaluatorEntity[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Introduction mode: optional hint from the introducer. */\n  introductionHint: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** When set (e.g. chat scope), networkId must match this. */\n  requiredNetworkId: Annotation<Id<'networks'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Set by intro_evaluation; used by persist to build manual detection and introducer actor. */\n  introductionContext: Annotation<{ createdByName?: string } | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Target opportunity ID for update/delete/send modes. */\n  opportunityId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** New status for update mode (e.g. 'accepted', 'rejected'). */\n  newStatus: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  // ─── Intermediate Fields (Accumulated) ───\n\n  /** User's indexed intents with hyde documents (from prep) */\n  indexedIntents: Annotation<IndexedIntent[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** User's network memberships (from prep) */\n  userNetworks: Annotation<Id<'networks'>[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Target indexes to search within (from scope) */\n  targetNetworks: Annotation<TargetNetwork[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Per-index relevancy scores for dedup tie-breaking. Background path: from intent_indexes. Chat path: transient from IntentIndexer. */\n  indexRelevancyScores: Annotation<Record<string, number>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({}),\n  }),\n\n  /** Whether discovery used intent (path A) or user context (path B/C). Used by persist for triggeredBy. In-memory routing state only; never persisted. */\n  discoverySource: Annotation<'intent' | 'context'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'intent',\n  }),\n\n  /** Resolved intent ID used for this discovery run (when discoverySource is 'intent'). Set by intent-resolution. */\n  resolvedTriggerIntentId: Annotation<Id<'intents'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Asker's profile (from prep). Used for profile-as-source discovery and evaluation. */\n  sourceProfile: Annotation<SourceProfileData | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /** User's active premises with embeddings (from prep). Used for premise-to-premise discovery path D. */\n  sourcePremises: Annotation<Array<{ premiseId: Id<'premises'>; embedding: number[] }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** User context embeddings per network (from prep). Used for context-to-intent discovery. */\n  sourceContexts: Annotation<Array<{ contextId: string; networkId: Id<'networks'>; text: string; embedding: number[] }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Resolved intent is in at least one target index (path A vs C). */\n  resolvedIntentInIndex: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n\n  /** Create-intent signal: when true, tool should return createIntentSuggested so agent can auto-call create_intent. */\n  createIntentSuggested: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n\n  /** Suggested description for create_intent when createIntentSuggested is true. */\n  suggestedIntentDescription: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** HyDE embeddings per lens label (from discovery) */\n  hydeEmbeddings: Annotation<Record<string, number[]>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({}),\n  }),\n\n  /** Candidate matches from semantic search (from discovery) */\n  candidates: Annotation<CandidateMatch[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Candidates not yet evaluated (for pagination -- cached in Redis by caller). */\n  remainingCandidates: Annotation<CandidateMatch[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Discovery session ID for pagination (maps to Redis cache key). */\n  discoveryId: Annotation<string | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /** Evaluated candidates with scores (from evaluation; legacy) */\n  evaluatedCandidates: Annotation<EvaluatedCandidate[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Evaluated opportunities with actors (from entity-bundle evaluator) */\n  evaluatedOpportunities: Annotation<EvaluatedOpportunity[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  // ─── Output Fields (Overwrite per turn) ───\n\n  /** Final ranked and persisted opportunities */\n  opportunities: Annotation<Opportunity[]>({\n    reducer: (curr, next) => next,\n    default: () => [],\n  }),\n\n  /** Discovery path: pairs skipped because an opportunity already exists between viewer and candidate (no duplicate created). */\n  existingBetweenActors: Annotation<Array<{\n    candidateUserId: Id<'users'>;\n    networkId: Id<'networks'>;\n    existingOpportunityId?: Id<'opportunities'>;\n    existingStatus?: OpportunityStatus;\n    reason?: 'same_trigger_recent_duplicate' | 'pair_active_negotiation' | 'final_atomic_conflict';\n    existingTriggerIntentId?: string;\n  }>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Typed persist-node counts used by queue telemetry. */\n  persistenceOutcome: Annotation<OpportunityPersistenceOutcome | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Positive exact-successor receipt for a fenced continuation. */\n  negotiationContinuationReceipt: Annotation<NegotiationContinuationReceipt | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Error message if any step fails */\n  error: Annotation<string | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  /** Output for read mode: enriched list of opportunities. */\n  readResult: Annotation<{\n    count: number;\n    message?: string;\n    opportunities: Array<{\n      id: string;\n      indexName: string;\n      connectedWith: string[];\n      suggestedBy: string | null;\n      reasoning: string;\n      status: string;\n      category: string;\n      confidence: number | null;\n      source: string | null;\n    }>;\n  } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  /** Output for update/delete/send modes. */\n  mutationResult: Annotation<{\n    success: boolean;\n    message?: string;\n    opportunityId?: string;\n    notified?: string[];\n    conversationId?: string;\n    error?: string;\n  } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  // ─── Trace Output ───\n\n  /**\n   * Accumulated trace entries from each graph node.\n   * Used for observability: surfaces internal processing steps (search query, HyDE strategies,\n   * candidates found, evaluation results) to the frontend.\n   */\n  trace: Annotation<Array<{ node: string; detail?: string; data?: Record<string, unknown> }>>({\n    reducer: (curr, next) => [...curr, ...(next || [])],\n    default: () => [],\n  }),\n\n  /** Timing records for each agent invocation within this graph run. */\n  agentTimings: Annotation<DebugMetaAgent[]>({\n    reducer: (acc, val) => [...acc, ...val],\n    default: () => [],\n  }),\n\n  /**\n   * Per-candidate negotiation records captured by `negotiateNode`. Populated\n   * regardless of accept/reject so the question generator sees a complete\n   * picture. Populated for ALL triggers (ambient + orchestrator) since the\n   * negotiate node's `onCandidateResolved` hook is unconditional; only the\n   * orchestrator streaming side-effects (opportunity_draft_ready emission)\n   * are trigger-gated. Empty when the negotiate node was skipped (no\n   * opportunities to negotiate).\n   */\n  discoveryNegotiations: Annotation<DiscoveryNegotiation[]>({\n    reducer: (curr, next) => [...curr, ...(next || [])],\n    default: () => [],\n  }),\n\n  /** Aggregate counters across `discoveryNegotiations`. Built in the negotiate node. */\n  discoverySummary: Annotation<DiscoverySummary | null>({\n    reducer: (_curr, next) => next ?? null,\n    default: () => null,\n  }),\n});\n"]}

package/dist/questioner/questioner.agent.d.ts

@@ -1,6 +1,6 @@
 import { type QuestionGenerationResult } from "../shared/schemas/question.schema.js";
 import { createStructuredModel } from "../shared/agent/model.config.js";
-import type { QuestionerInput } from "./questioner.types.js";
+import { type QuestionerInput } from "./questioner.types.js";
 export interface QuestionerAgentConfig {
     /** Optional model config override. */
     modelConfig?: Parameters<typeof createStructuredModel>[3];

package/dist/questioner/questioner.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"questioner.agent.d.ts","sourceRoot":"/","sources":["questioner/questioner.agent.ts"],"names":[],"mappings":"AAWA,OAAO,EAAkD,KAAK,wBAAwB,EAAoD,MAAM,sCAAsC,CAAC;AACvL,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAKxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3D;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA2C;gBAE5C,MAAM,CAAC,EAAE,qBAAqB;IAM1C;;;;;;;;OAQG;IAEG,MAAM,CACV,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;CA+C5C"}
+{"version":3,"file":"questioner.agent.d.ts","sourceRoot":"/","sources":["questioner/questioner.agent.ts"],"names":[],"mappings":"AAWA,OAAO,EAAkD,KAAK,wBAAwB,EAAoD,MAAM,sCAAsC,CAAC;AACvL,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAKxE,OAAO,EAAkC,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7F,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3D;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA2C;gBAE5C,MAAM,CAAC,EAAE,qBAAqB;IAM1C;;;;;;;;OAQG;IAEG,MAAM,CACV,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;CAmD5C"}

package/dist/questioner/questioner.agent.js

@@ -23,6 +23,7 @@ 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 "./questioner.presets.js";
+import { isValidQuestionerInputContract } from "./questioner.types.js";
 const logger = protocolLogger("QuestionerAgent");
 /** Maximum same-strategy questions allowed in a single emission. */
 const MAX_SAME_STRATEGY = 2;
@@ -47,7 +48,11 @@ export class QuestionerAgent {
      *   the LLM threw, or the call was aborted.
      */
     async invoke(input, options) {
-        const preset = getPreset(input.mode);
+        if (!isValidQuestionerInputContract(input)) {
+            logger.warn('QuestionerAgent rejected invalid mode/purpose/context contract', { mode: input.mode });
+            return null;
+        }
+        const preset = getPreset(input.mode, input.purpose);
         const userMessage = preset.buildPrompt(input.context);
         let raw;
         try {

package/dist/questioner/questioner.agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"questioner.agent.js","sourceRoot":"/","sources":["questioner/questioner.agent.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * QuestionerAgent — stateless, mode-driven agent that generates structured\n * decision questions from arbitrary protocol contexts.\n *\n * Follows the IndexNegotiator pattern: constructor takes optional config,\n * single public `invoke()` method receives the full context per call.\n * The LLM model is bound once at construction; the preset (system prompt +\n * builder) is selected per invocation based on `input.mode`.\n */\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\n\nimport { QuestionGeneratorResponseSchema, type Question, type QuestionGenerationResult, type QuestionStrategy, type QuestionWithStrategy } from \"../shared/schemas/question.schema.js\";\nimport { createStructuredModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\nimport { getPreset } from \"./questioner.presets.js\";\nimport type { QuestionerInput } from \"./questioner.types.js\";\n\nconst logger = protocolLogger(\"QuestionerAgent\");\n\n/** Maximum same-strategy questions allowed in a single emission. */\nconst MAX_SAME_STRATEGY = 2;\n\nexport interface QuestionerAgentConfig {\n  /** Optional model config override. */\n  modelConfig?: Parameters<typeof createStructuredModel>[3];\n}\n\n/**\n * Stateless question-generation agent. Accepts a `QuestionerInput` envelope,\n * selects the preset for the given mode, invokes the LLM, and applies\n * guardrails (dedup + strategy diversity).\n */\nexport class QuestionerAgent {\n  private model: ReturnType<typeof createStructuredModel>;\n\n  constructor(config?: QuestionerAgentConfig) {\n    this.model = createStructuredModel(\"questioner\", QuestionGeneratorResponseSchema, {\n      name: \"clarifying_questions\",\n    }, config?.modelConfig);\n  }\n\n  /**\n   * Generate up to 3 decision questions from the given input.\n   *\n   * @param input  Envelope with mode, userId, source info, and mode-specific context.\n   * @param options.signal  Optional AbortSignal to cancel the in-flight LLM call.\n   * @returns A result with parallel questions[] and strategies[] arrays,\n   *   or null when generation failed, guardrails dropped all candidates,\n   *   the LLM threw, or the call was aborted.\n   */\n  @Timed()\n  async invoke(\n    input: QuestionerInput,\n    options?: { signal?: AbortSignal },\n  ): Promise<QuestionGenerationResult | null> {\n    const preset = getPreset(input.mode);\n    const userMessage = preset.buildPrompt(input.context);\n\n    let raw: unknown;\n    try {\n      raw = await invokeWithAbortSignal(\n        this.model,\n        [new SystemMessage(preset.systemPrompt), new HumanMessage(userMessage)],\n        options?.signal,\n      );\n    } catch (err) {\n      const aborted = options?.signal?.aborted ?? false;\n      if (aborted) {\n        logger.info(\"QuestionerAgent aborted by signal\", {\n          mode: input.mode,\n          reason: options?.signal?.reason instanceof Error\n            ? options.signal.reason.message\n            : String(options?.signal?.reason ?? \"unknown\"),\n        });\n      } else {\n        logger.warn(\"QuestionerAgent LLM call failed\", {\n          mode: input.mode,\n          error: err instanceof Error ? err.message : String(err),\n        });\n      }\n      return null;\n    }\n\n    const parsed = QuestionGeneratorResponseSchema.safeParse(raw);\n    if (!parsed.success) {\n      logger.warn(\"QuestionerAgent parse failed\", {\n        mode: input.mode,\n        error: parsed.error.message,\n      });\n      return null;\n    }\n\n    const filtered = applyGuardrails(parsed.data.questions);\n    if (filtered.length === 0) return null;\n\n    return {\n      questions: filtered.map(stripInternalMetadata),\n      strategies: filtered.map((q) => q.strategy),\n      underspecificationTypes: filtered.map((q) => q.underspecificationType),\n    };\n  }\n}\n\n// --- Guardrails (migrated from question.generator.ts) -------------------------\n\nfunction applyGuardrails(questions: QuestionWithStrategy[]): QuestionWithStrategy[] {\n  const dedupedByTitle = dedupByTitle(questions);\n  return enforceStrategyDiversity(dedupedByTitle);\n}\n\nfunction dedupByTitle(questions: QuestionWithStrategy[]): QuestionWithStrategy[] {\n  const seen = new Set<string>();\n  const out: QuestionWithStrategy[] = [];\n  for (const q of questions) {\n    if (seen.has(q.title)) continue;\n    seen.add(q.title);\n    out.push(q);\n  }\n  return out;\n}\n\nfunction enforceStrategyDiversity(\n  questions: QuestionWithStrategy[],\n): QuestionWithStrategy[] {\n  const counts = new Map<QuestionStrategy, number>();\n  const out: QuestionWithStrategy[] = [];\n  for (const q of questions) {\n    const n = counts.get(q.strategy) ?? 0;\n    if (n >= MAX_SAME_STRATEGY) continue;\n    counts.set(q.strategy, n + 1);\n    out.push(q);\n  }\n  return out;\n}\n\nfunction stripInternalMetadata(q: QuestionWithStrategy): Question {\n  const {\n    strategy: _strategy,\n    underspecificationType: _underspecificationType,\n    ...publicShape\n  } = q;\n  return publicShape;\n}\n"]}
+{"version":3,"file":"questioner.agent.js","sourceRoot":"/","sources":["questioner/questioner.agent.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * QuestionerAgent — stateless, mode-driven agent that generates structured\n * decision questions from arbitrary protocol contexts.\n *\n * Follows the IndexNegotiator pattern: constructor takes optional config,\n * single public `invoke()` method receives the full context per call.\n * The LLM model is bound once at construction; the preset (system prompt +\n * builder) is selected per invocation based on `input.mode`.\n */\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\n\nimport { QuestionGeneratorResponseSchema, type Question, type QuestionGenerationResult, type QuestionStrategy, type QuestionWithStrategy } from \"../shared/schemas/question.schema.js\";\nimport { createStructuredModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\nimport { getPreset } from \"./questioner.presets.js\";\nimport { isValidQuestionerInputContract, type QuestionerInput } from \"./questioner.types.js\";\n\nconst logger = protocolLogger(\"QuestionerAgent\");\n\n/** Maximum same-strategy questions allowed in a single emission. */\nconst MAX_SAME_STRATEGY = 2;\n\nexport interface QuestionerAgentConfig {\n  /** Optional model config override. */\n  modelConfig?: Parameters<typeof createStructuredModel>[3];\n}\n\n/**\n * Stateless question-generation agent. Accepts a `QuestionerInput` envelope,\n * selects the preset for the given mode, invokes the LLM, and applies\n * guardrails (dedup + strategy diversity).\n */\nexport class QuestionerAgent {\n  private model: ReturnType<typeof createStructuredModel>;\n\n  constructor(config?: QuestionerAgentConfig) {\n    this.model = createStructuredModel(\"questioner\", QuestionGeneratorResponseSchema, {\n      name: \"clarifying_questions\",\n    }, config?.modelConfig);\n  }\n\n  /**\n   * Generate up to 3 decision questions from the given input.\n   *\n   * @param input  Envelope with mode, userId, source info, and mode-specific context.\n   * @param options.signal  Optional AbortSignal to cancel the in-flight LLM call.\n   * @returns A result with parallel questions[] and strategies[] arrays,\n   *   or null when generation failed, guardrails dropped all candidates,\n   *   the LLM threw, or the call was aborted.\n   */\n  @Timed()\n  async invoke(\n    input: QuestionerInput,\n    options?: { signal?: AbortSignal },\n  ): Promise<QuestionGenerationResult | null> {\n    if (!isValidQuestionerInputContract(input)) {\n      logger.warn('QuestionerAgent rejected invalid mode/purpose/context contract', { mode: input.mode });\n      return null;\n    }\n    const preset = getPreset(input.mode, input.purpose);\n    const userMessage = preset.buildPrompt(input.context);\n\n    let raw: unknown;\n    try {\n      raw = await invokeWithAbortSignal(\n        this.model,\n        [new SystemMessage(preset.systemPrompt), new HumanMessage(userMessage)],\n        options?.signal,\n      );\n    } catch (err) {\n      const aborted = options?.signal?.aborted ?? false;\n      if (aborted) {\n        logger.info(\"QuestionerAgent aborted by signal\", {\n          mode: input.mode,\n          reason: options?.signal?.reason instanceof Error\n            ? options.signal.reason.message\n            : String(options?.signal?.reason ?? \"unknown\"),\n        });\n      } else {\n        logger.warn(\"QuestionerAgent LLM call failed\", {\n          mode: input.mode,\n          error: err instanceof Error ? err.message : String(err),\n        });\n      }\n      return null;\n    }\n\n    const parsed = QuestionGeneratorResponseSchema.safeParse(raw);\n    if (!parsed.success) {\n      logger.warn(\"QuestionerAgent parse failed\", {\n        mode: input.mode,\n        error: parsed.error.message,\n      });\n      return null;\n    }\n\n    const filtered = applyGuardrails(parsed.data.questions);\n    if (filtered.length === 0) return null;\n\n    return {\n      questions: filtered.map(stripInternalMetadata),\n      strategies: filtered.map((q) => q.strategy),\n      underspecificationTypes: filtered.map((q) => q.underspecificationType),\n    };\n  }\n}\n\n// --- Guardrails (migrated from question.generator.ts) -------------------------\n\nfunction applyGuardrails(questions: QuestionWithStrategy[]): QuestionWithStrategy[] {\n  const dedupedByTitle = dedupByTitle(questions);\n  return enforceStrategyDiversity(dedupedByTitle);\n}\n\nfunction dedupByTitle(questions: QuestionWithStrategy[]): QuestionWithStrategy[] {\n  const seen = new Set<string>();\n  const out: QuestionWithStrategy[] = [];\n  for (const q of questions) {\n    if (seen.has(q.title)) continue;\n    seen.add(q.title);\n    out.push(q);\n  }\n  return out;\n}\n\nfunction enforceStrategyDiversity(\n  questions: QuestionWithStrategy[],\n): QuestionWithStrategy[] {\n  const counts = new Map<QuestionStrategy, number>();\n  const out: QuestionWithStrategy[] = [];\n  for (const q of questions) {\n    const n = counts.get(q.strategy) ?? 0;\n    if (n >= MAX_SAME_STRATEGY) continue;\n    counts.set(q.strategy, n + 1);\n    out.push(q);\n  }\n  return out;\n}\n\nfunction stripInternalMetadata(q: QuestionWithStrategy): Question {\n  const {\n    strategy: _strategy,\n    underspecificationType: _underspecificationType,\n    ...publicShape\n  } = q;\n  return publicShape;\n}\n"]}

package/dist/questioner/questioner.presets.d.ts

@@ -4,7 +4,7 @@
  * context object. Only the `discovery` preset ships in Slice 1; others throw
  * until their implementation slices land.
  */
-import type { QuestionMode } from "../shared/schemas/question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "../shared/schemas/question.schema.js";
 export interface QuestionerPreset {
     /** The LLM system prompt for this mode. */
     systemPrompt: string;
@@ -17,5 +17,5 @@ export interface QuestionerPreset {
  * @returns The matching preset with systemPrompt and buildPrompt.
  * @throws Error if the mode's preset is not yet implemented.
  */
-export declare function getPreset(mode: QuestionMode): QuestionerPreset;
+export declare function getPreset(mode: QuestionMode, purpose?: QuestionPurpose): QuestionerPreset;
 //# sourceMappingURL=questioner.presets.d.ts.map

package/dist/questioner/questioner.presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"questioner.presets.d.ts","sourceRoot":"/","sources":["questioner/questioner.presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAsBzE,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAC3C;AAgbD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB,CAM9D"}
+{"version":3,"file":"questioner.presets.d.ts","sourceRoot":"/","sources":["questioner/questioner.presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAsB1F,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAC3C;AA2dD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAYzF"}

package/dist/questioner/questioner.presets.js

@@ -80,6 +80,51 @@ function buildIntentPrompt(ctx) {
         "Return an empty `questions` array if the intent is already specific enough.",
     ].join("\n");
 }
+const RECOVERY_INTENT_SYSTEM_PROMPT = `You help a user materially refine one of their own discovery signals after an authoritative discovery run completed without leaving a currently actionable opportunity. Ask directly about the user's goal, desired counterpart attributes, or constraints. Never describe the run or imply that any specific person was reviewed.
+
+Choose exactly one of these strategies:
+- refine_intent: sharpen or pivot the core signal in a way that changes who should surface.
+- surface_missing_detail: ask for one concrete missing constraint such as stage, location, timing, budget, format, or required capability.
+
+Ask a question only when the answer is not already inferable from the intent, summary, or user profile and would materially change discovery. If no safe, useful missing axis exists, return an empty questions array.
+
+Standalone prompt rule. The prompt must identify the user's intent topic in plain language and ask about their own goal or constraints. It must make sense without UI labels or hidden metadata.
+
+${REFERENTIAL_CLOSURE_RULES}
+
+Privacy and process boundary. You may receive only a bounded aggregate count of validated prior outcomes. Use it solely as a weak signal to choose a missing axis. Never mention or imply counts, matches, no matches, rejections, negotiations, candidates, counterparties, searches, retries, pipeline state, evidence, or what another person did or did not say. Never invent people or facts.
+
+Cardinality. Return at most ONE question. Use only refine_intent or surface_missing_detail. The question must nudge a material edit, not ask whether to search again.
+
+Option construction. Provide 2–4 materially different outcomes. Put the safest or most common path first with " (Recommended)" when appropriate. Descriptions state the discovery consequence. Never add an Other option.
+
+Title rules. ≤12 chars and name the decision domain, such as Scope, Timing, Location, Stage, Budget, Format, or Skills.
+
+Output. Return zero or one question. Set underspecificationType to the applicable QUD category, or null when none applies.`;
+function buildRecoveryIntentPrompt(ctx) {
+    return [
+        "## Intent",
+        ctx.payload,
+        "",
+        "## Summary",
+        ctx.summary?.trim() || "(no summary available)",
+        "",
+        "## User profile",
+        buildUserContextBlock(ctx.userContext),
+        ...(ctx.rejectedNegotiationCount
+            ? [
+                "",
+                "## Private aggregate signal",
+                `Validated prior outcomes without an actionable connection: ${ctx.rejectedNegotiationCount}`,
+            ]
+            : []),
+        "",
+        "## Your task",
+        "Ask at most one direct question whose answer would materially refine this intent.",
+        "Do not narrate discovery outcomes or internal process state in the question.",
+        "Return an empty `questions` array when no safe useful axis is missing.",
+    ].join("\n");
+}
 // ─── Profile preset ─────────────────────────────────────────────────────────
 const PROFILE_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. The user has a profile that is incomplete. Your job: surface the minimum set of structured questions that fill the identified gaps — asking about location, skills, interests, current work, or goals — so the protocol can run better discovery on their behalf.
 
@@ -145,7 +190,7 @@ const NEGOTIATION_SYSTEM_PROMPT = `You sit between a human and a discovery proto
 
 POST-STALL purpose. A negotiation between this user and another person ended without a clear outcome — either the turn budget was exhausted, the session timed out, or conversation stalled. Surface the minimum set of structured questions that help the user provide the missing signal needed to unblock or refine the next discovery attempt.
 
-UPTAKE purpose. The user is considering accepting a proposed connection, but one preparatory condition about the other person's practical ability, resources, availability, or authority to carry out the proposed activity needs clarification before commitment. Generate exactly ONE neutral question that lets the user decide whether they understand that condition well enough to proceed. Ask about the concrete activity and the other person's stated attributes; do not accuse, challenge credibility, or presume incapability. Never reveal a numeric authority score, threshold, felicity label, evaluator judgment, or any internal matching/verification mechanics. Do not ask whether the user wants to accept; clarify the preparatory condition only.
+UPTAKE purpose. The user is considering accepting a proposed connection, but one preparatory condition about the other person's practical ability, resources, availability, or authority to carry out the proposed activity needs clarification before commitment. Generate exactly ONE neutral question that lets the user decide whether they understand that condition well enough to proceed. Ask about the concrete activity and refer to the other participant generically; do not accuse, challenge credibility, presume incapability, or invent/repeat profile attributes. Never reveal a numeric authority score, threshold, felicity label, evaluator judgment, or any internal matching/verification mechanics. Do not ask whether the user wants to accept; clarify the preparatory condition only.
 
 You may pick from three strategies. Choose contextually; mix only when each question is genuinely distinct.
 - refine_intent: help the user sharpen their underlying signal based on what the negotiation revealed (scope, scale, priority, direction).
@@ -157,7 +202,7 @@ Ask a question only when ALL of these hold:
 2. The answer would materially change how the next attempt surfaces or engages candidates.
 3. The question targets a different decision domain from any other question in this batch.
 
-Standalone prompt rule. Every generated \`prompt\` must be understandable outside the conversation where it was created. Naturally include the user's underlying goal or topic and the relevant community in the question text itself, in plain language drawn from their intent or profile — NOT the mechanics of the match attempt. Do not rely on \`title\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.
+Standalone prompt rule. Every generated \`prompt\` must be understandable outside the conversation where it was created. Naturally include the user's own underlying goal or topic and, only when supplied as a source-safe label, the relevant community in the question text itself. Never infer or repeat counterparty identity/profile, private transcript, evaluator reasoning, match reasons, event/community attendance, or internal IDs/metadata. Do not rely on \`title\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.
 - Bad: "Which role is a better fit for your immediate needs?"
 - Good: "For your search for AI infrastructure collaborators in the AI founders community, what kind of working relationship fits your immediate needs?"
 
@@ -189,11 +234,11 @@ function buildPostStallNegotiationPrompt(ctx) {
         "",
         "## Negotiation context",
         `Community: ${ctx.indexContext}`,
-        `Counterparty: ${ctx.counterpartyHint}`,
+        `Other participant: ${ctx.counterpartyHint}`,
         `Stall reason: ${ctx.outcomeReason}`,
         "",
-        "## Key takeaway",
-        ctx.keyTake,
+        "## Recipient's own signal",
+        ctx.recipientIntent,
         "",
         "## User profile",
         profileBlock,
@@ -206,7 +251,6 @@ function buildPostStallNegotiationPrompt(ctx) {
 }
 function buildUptakeNegotiationPrompt(ctx) {
     const profileBlock = buildUserContextBlock(ctx.userContext);
-    const evidence = ctx.preparatoryEvidence?.trim() || "(no additional public evidence provided)";
     return [
         "## Purpose",
         "UPTAKE — preparatory-condition clarification before acceptance",
@@ -220,9 +264,6 @@ function buildUptakeNegotiationPrompt(ctx) {
         "## Community",
         ctx.indexContext,
         "",
-        "## Public preparatory evidence",
-        evidence,
-        "",
         "## User profile",
         profileBlock,
         "",
@@ -248,13 +289,13 @@ You may pick from two strategies. Choose contextually; mix only when each questi
 
 Honor the negotiator's intent. When a draft question is provided, treat it as the source of truth for WHAT to ask — improve wording, tighten options, add consequence-focused descriptions. Do not invent questions about topics the negotiator did not raise. When no draft is provided, derive the question strictly from the disclosure subject.
 
-Standalone prompt rule. Every generated \`prompt\` must be understandable outside the conversation where it was created. The user may see this question hours later in an inbox, away from any negotiation view. Naturally include the disclosure subject and a concrete description of the other person (drawn from the counterparty hint — their attributes, e.g. "a Berlin-based AI-infrastructure founder") in the question text itself. Do not rely on \`title\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.
-- Bad: "Can I share your budget with them?"
-- Good: "May I share your budget range with a Berlin-based AI-infrastructure founder you're being matched with?"
+Standalone prompt rule. Every generated \`prompt\` must be understandable outside the conversation where it was created. The user may see this question hours later in an inbox, away from any negotiation view. Include the disclosure subject and the generic phrase "the other participant in this match" in the question text itself. Never repeat or infer counterparty identity/profile, private transcript, evaluator reasoning, match reasons, event/community attendance, or internal IDs/metadata. Do not rely on \`title\`, UI labels, hidden metadata, or surrounding digest/chat text.
+- Bad: "May I share your budget with Alex, a Berlin-based founder from the event?"
+- Good: "May I share your budget range with the other participant in this match?"
 
 ${REFERENTIAL_CLOSURE_RULES}
 
-Exception — describing the other side. Unlike other surfaces, this question is ABOUT a live counterparty, so you must reference them — do it by restating their concrete attributes from the counterparty hint ("a fintech CTO exploring agent tooling"), never as "the counterparty", "them", or "this person" without an attribute anchor in the same sentence, and never by implying a list or pipeline.
+Exception — describing the other side. This question may refer to the other participant generically because it is tied to one exact server-validated opportunity. Do not add attributes, identity, or claims about why they matched.
 
 Cardinality. Default one question. Add a second ONLY when the negotiator's need genuinely spans two distinct decisions (e.g. one disclosure gate plus one missing fact). Never pad.
 
@@ -410,7 +451,13 @@ const presets = {
  * @returns The matching preset with systemPrompt and buildPrompt.
  * @throws Error if the mode's preset is not yet implemented.
  */
-export function getPreset(mode) {
+export function getPreset(mode, purpose) {
+    if (mode === "intent" && purpose === "recovery") {
+        return {
+            systemPrompt: withQudMetadataRules(RECOVERY_INTENT_SYSTEM_PROMPT),
+            buildPrompt: (context) => buildRecoveryIntentPrompt(context),
+        };
+    }
     const preset = presets[mode];
     if (!preset) {
         throw new Error(`QuestionerAgent preset "${mode}" is not implemented yet`);