@indexnetwork/protocol 0.4.0-rc.13.1 → 0.4.0-rc.15.1

package/dist/negotiation/negotiation.graph.d.ts

@@ -1,31 +1,17 @@
 import { type TraceEmitter } from "../shared/observability/request-context.js";
 import type { NegotiationDatabase } from "../shared/interfaces/database.interface.js";
-import type { WebhookLookup, NegotiationEventEmitter, NegotiationTimeoutQueue } from "../shared/interfaces/negotiation-events.interface.js";
-import { type NegotiationTurn, type NegotiationOutcome, type UserNegotiationContext, type SeedAssessment, type NegotiationGraphLike } from "./negotiation.state.js";
-interface NegotiationAgentLike {
-    invoke(input: {
-        ownUser: UserNegotiationContext;
-        otherUser: UserNegotiationContext;
-        indexContext: {
-            networkId: string;
-            prompt: string;
-        };
-        seedAssessment: SeedAssessment;
-        history: NegotiationTurn[];
-    }): Promise<NegotiationTurn>;
-}
+import type { NegotiationTimeoutQueue } from "../shared/interfaces/negotiation-events.interface.js";
+import type { AgentDispatcher } from "../shared/interfaces/agent-dispatcher.interface.js";
+import { type NegotiationOutcome, type UserNegotiationContext, type SeedAssessment, type NegotiationGraphLike } from "./negotiation.state.js";
 /**
  * Factory for the bilateral negotiation LangGraph state machine.
- * @remarks Accepts dependencies via constructor for testability.
+ * @remarks Accepts an AgentDispatcher for per-turn agent resolution.
  */
 export declare class NegotiationGraphFactory {
     private database;
-    private proposer;
-    private responder;
-    private webhookLookup?;
-    private eventEmitter?;
+    private dispatcher;
     private timeoutQueue?;
-    constructor(database: NegotiationDatabase, proposer: NegotiationAgentLike, responder: NegotiationAgentLike, webhookLookup?: WebhookLookup | undefined, eventEmitter?: NegotiationEventEmitter | undefined, timeoutQueue?: NegotiationTimeoutQueue | undefined);
+    constructor(database: NegotiationDatabase, dispatcher: AgentDispatcher, timeoutQueue?: NegotiationTimeoutQueue | undefined);
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         sourceUser: UserNegotiationContext;
         candidateUser: UserNegotiationContext;
@@ -34,35 +20,36 @@ export declare class NegotiationGraphFactory {
             prompt: string;
         };
         seedAssessment: SeedAssessment;
+        discoveryQuery: string | undefined;
+        opportunityId: string;
         conversationId: string;
         taskId: string;
         messages: import("./negotiation.state.js").NegotiationMessage[];
         turnCount: number;
-        maxTurns: number;
+        maxTurns: number | undefined;
+        timeoutMs: number;
         currentSpeaker: "source" | "candidate";
         lastTurn: {
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null;
-        status: "active" | "waiting_for_external" | "completed";
-        yieldForExternal: boolean;
+        status: "active" | "waiting_for_agent" | "completed";
         outcome: {
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null;
         error: string | null;
     }, {
@@ -76,55 +63,55 @@ export declare class NegotiationGraphFactory {
             prompt: string;
         }> | undefined;
         seedAssessment?: SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment> | undefined;
+        discoveryQuery?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        opportunityId?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
         conversationId?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
         taskId?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
         messages?: import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]> | undefined;
         turnCount?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
-        maxTurns?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
+        maxTurns?: number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined;
+        timeoutMs?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
         currentSpeaker?: "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate"> | undefined;
         lastTurn?: {
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null> | null | undefined;
-        status?: "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed"> | undefined;
-        yieldForExternal?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
+        status?: "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed"> | undefined;
         outcome?: {
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null> | null | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | null> | null | undefined;
     }, "__start__" | "init" | "turn" | "finalize", {
@@ -141,75 +128,74 @@ export declare class NegotiationGraphFactory {
             prompt: string;
         }>, unknown>;
         seedAssessment: import("@langchain/langgraph").BaseChannel<SeedAssessment, SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment>, unknown>;
+        discoveryQuery: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        opportunityId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         conversationId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         taskId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         messages: import("@langchain/langgraph").BaseChannel<import("./negotiation.state.js").NegotiationMessage[], import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]>, unknown>;
         turnCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        maxTurns: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+        maxTurns: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+        timeoutMs: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
         currentSpeaker: import("@langchain/langgraph").BaseChannel<"source" | "candidate", "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate">, unknown>;
         lastTurn: import("@langchain/langgraph").BaseChannel<{
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null, {
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null> | null, unknown>;
-        status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_external" | "completed", "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed">, unknown>;
-        yieldForExternal: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_agent" | "completed", "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed">, unknown>;
         outcome: import("@langchain/langgraph").BaseChannel<{
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null, {
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null> | null, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
     }, {
@@ -226,75 +212,74 @@ export declare class NegotiationGraphFactory {
             prompt: string;
         }>, unknown>;
         seedAssessment: import("@langchain/langgraph").BaseChannel<SeedAssessment, SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment>, unknown>;
+        discoveryQuery: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        opportunityId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         conversationId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         taskId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         messages: import("@langchain/langgraph").BaseChannel<import("./negotiation.state.js").NegotiationMessage[], import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]>, unknown>;
         turnCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        maxTurns: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+        maxTurns: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+        timeoutMs: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
         currentSpeaker: import("@langchain/langgraph").BaseChannel<"source" | "candidate", "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate">, unknown>;
         lastTurn: import("@langchain/langgraph").BaseChannel<{
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null, {
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null> | null, unknown>;
-        status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_external" | "completed", "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed">, unknown>;
-        yieldForExternal: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_agent" | "completed", "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed">, unknown>;
         outcome: import("@langchain/langgraph").BaseChannel<{
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null, {
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null> | null, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
     }, import("@langchain/langgraph").StateDefinition, {
@@ -303,6 +288,7 @@ export declare class NegotiationGraphFactory {
             taskId: string;
             currentSpeaker: "source";
             turnCount: number;
+            maxTurns: number;
             error?: undefined;
         } | {
             error: string;
@@ -310,6 +296,7 @@ export declare class NegotiationGraphFactory {
             taskId?: undefined;
             currentSpeaker?: undefined;
             turnCount?: undefined;
+            maxTurns?: undefined;
         };
         turn: import("@langchain/langgraph").UpdateType<{
             sourceUser: import("@langchain/langgraph").BaseChannel<UserNegotiationContext, UserNegotiationContext | import("@langchain/langgraph").OverwriteValue<UserNegotiationContext>, unknown>;
@@ -325,75 +312,74 @@ export declare class NegotiationGraphFactory {
                 prompt: string;
             }>, unknown>;
             seedAssessment: import("@langchain/langgraph").BaseChannel<SeedAssessment, SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment>, unknown>;
+            discoveryQuery: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            opportunityId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             conversationId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             taskId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             messages: import("@langchain/langgraph").BaseChannel<import("./negotiation.state.js").NegotiationMessage[], import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]>, unknown>;
             turnCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-            maxTurns: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+            maxTurns: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+            timeoutMs: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
             currentSpeaker: import("@langchain/langgraph").BaseChannel<"source" | "candidate", "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate">, unknown>;
             lastTurn: import("@langchain/langgraph").BaseChannel<{
-                action: "propose" | "accept" | "reject" | "counter";
+                action: "propose" | "accept" | "reject" | "counter" | "question";
                 assessment: {
                     reasoning: string;
-                    fitScore: number;
                     suggestedRoles: {
                         ownUser: "agent" | "patient" | "peer";
                         otherUser: "agent" | "patient" | "peer";
                     };
                 };
+                message?: string | null | undefined;
             } | null, {
-                action: "propose" | "accept" | "reject" | "counter";
+                action: "propose" | "accept" | "reject" | "counter" | "question";
                 assessment: {
                     reasoning: string;
-                    fitScore: number;
                     suggestedRoles: {
                         ownUser: "agent" | "patient" | "peer";
                         otherUser: "agent" | "patient" | "peer";
                     };
                 };
+                message?: string | null | undefined;
             } | import("@langchain/langgraph").OverwriteValue<{
-                action: "propose" | "accept" | "reject" | "counter";
+                action: "propose" | "accept" | "reject" | "counter" | "question";
                 assessment: {
                     reasoning: string;
-                    fitScore: number;
                     suggestedRoles: {
                         ownUser: "agent" | "patient" | "peer";
                         otherUser: "agent" | "patient" | "peer";
                     };
                 };
+                message?: string | null | undefined;
             } | null> | null, unknown>;
-            status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_external" | "completed", "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed">, unknown>;
-            yieldForExternal: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+            status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_agent" | "completed", "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed">, unknown>;
             outcome: import("@langchain/langgraph").BaseChannel<{
                 reasoning: string;
                 hasOpportunity: boolean;
-                finalScore: number;
                 agreedRoles: {
                     userId: string;
                     role: "agent" | "patient" | "peer";
                 }[];
                 turnCount: number;
-                reason?: string | undefined;
+                reason?: "timeout" | "turn_cap" | undefined;
             } | null, {
                 reasoning: string;
                 hasOpportunity: boolean;
-                finalScore: number;
                 agreedRoles: {
                     userId: string;
                     role: "agent" | "patient" | "peer";
                 }[];
                 turnCount: number;
-                reason?: string | undefined;
+                reason?: "timeout" | "turn_cap" | undefined;
             } | import("@langchain/langgraph").OverwriteValue<{
                 reasoning: string;
                 hasOpportunity: boolean;
-                finalScore: number;
                 agreedRoles: {
                     userId: string;
                     role: "agent" | "patient" | "peer";
                 }[];
                 turnCount: number;
-                reason?: string | undefined;
+                reason?: "timeout" | "turn_cap" | undefined;
             } | null> | null, unknown>;
             error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
         }>;
@@ -404,13 +390,12 @@ export declare class NegotiationGraphFactory {
             outcome: {
                 reasoning: string;
                 hasOpportunity: boolean;
-                finalScore: number;
                 agreedRoles: {
                     userId: string;
                     role: "agent" | "patient" | "peer";
                 }[];
                 turnCount: number;
-                reason?: string | undefined;
+                reason?: "timeout" | "turn_cap" | undefined;
             };
             status: "completed";
         };
@@ -418,26 +403,21 @@ export declare class NegotiationGraphFactory {
 }
 export interface NegotiationCandidate {
     userId: string;
-    score: number;
     reasoning: string;
     valencyRole: string;
     networkId?: string;
     candidateUser: UserNegotiationContext;
+    /** The explicit search query that triggered discovery (if any). */
+    discoveryQuery?: string;
 }
 export interface NegotiationResult {
     userId: string;
-    negotiationScore: number;
     agreedRoles: NegotiationOutcome["agreedRoles"];
     reasoning: string;
     turnCount: number;
 }
 /**
  * Runs bilateral negotiation for each candidate in parallel.
- * @param negotiationGraph - Compiled negotiation graph
- * @param sourceUser - Source user context
- * @param candidates - Evaluated candidates to negotiate with
- * @param indexContext - Index context for the negotiation
- * @param opts - Optional maxTurns and traceEmitter
  * @returns Only candidates that produced an opportunity
  */
 export declare function negotiateCandidates(negotiationGraph: NegotiationGraphLike, sourceUser: UserNegotiationContext, candidates: NegotiationCandidate[], indexContext: {
@@ -447,20 +427,14 @@ export declare function negotiateCandidates(negotiationGraph: NegotiationGraphLi
     maxTurns?: number;
     traceEmitter?: TraceEmitter;
     indexContextOverrides?: Map<string, string>;
-    yieldForExternal?: boolean;
+    timeoutMs?: number;
 }): Promise<NegotiationResult[]>;
 /**
  * Creates a negotiation graph with the provided dependencies.
- * @param deps.database - Conversation database adapter
- * @param deps.proposer - Agent that proposes negotiation terms
- * @param deps.responder - Agent that responds to negotiation proposals
  */
 export declare function createDefaultNegotiationGraph(deps: {
     database: NegotiationDatabase;
-    proposer: NegotiationAgentLike;
-    responder: NegotiationAgentLike;
-    webhookLookup?: WebhookLookup;
-    eventEmitter?: NegotiationEventEmitter;
+    dispatcher: AgentDispatcher;
     timeoutQueue?: NegotiationTimeoutQueue;
 }): import("@langchain/langgraph").CompiledStateGraph<{
     sourceUser: UserNegotiationContext;
@@ -470,35 +444,36 @@ export declare function createDefaultNegotiationGraph(deps: {
         prompt: string;
     };
     seedAssessment: SeedAssessment;
+    discoveryQuery: string | undefined;
+    opportunityId: string;
     conversationId: string;
     taskId: string;
     messages: import("./negotiation.state.js").NegotiationMessage[];
     turnCount: number;
-    maxTurns: number;
+    maxTurns: number | undefined;
+    timeoutMs: number;
     currentSpeaker: "source" | "candidate";
     lastTurn: {
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | null;
-    status: "active" | "waiting_for_external" | "completed";
-    yieldForExternal: boolean;
+    status: "active" | "waiting_for_agent" | "completed";
     outcome: {
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | null;
     error: string | null;
 }, {
@@ -512,55 +487,55 @@ export declare function createDefaultNegotiationGraph(deps: {
         prompt: string;
     }> | undefined;
     seedAssessment?: SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment> | undefined;
+    discoveryQuery?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+    opportunityId?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
     conversationId?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
     taskId?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
     messages?: import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]> | undefined;
     turnCount?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
-    maxTurns?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
+    maxTurns?: number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined;
+    timeoutMs?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
     currentSpeaker?: "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate"> | undefined;
     lastTurn?: {
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | import("@langchain/langgraph").OverwriteValue<{
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | null> | null | undefined;
-    status?: "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed"> | undefined;
-    yieldForExternal?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
+    status?: "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed"> | undefined;
     outcome?: {
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | import("@langchain/langgraph").OverwriteValue<{
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | null> | null | undefined;
     error?: string | import("@langchain/langgraph").OverwriteValue<string | null> | null | undefined;
 }, "__start__" | "init" | "turn" | "finalize", {
@@ -577,75 +552,74 @@ export declare function createDefaultNegotiationGraph(deps: {
         prompt: string;
     }>, unknown>;
     seedAssessment: import("@langchain/langgraph").BaseChannel<SeedAssessment, SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment>, unknown>;
+    discoveryQuery: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    opportunityId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
     conversationId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
     taskId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
     messages: import("@langchain/langgraph").BaseChannel<import("./negotiation.state.js").NegotiationMessage[], import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]>, unknown>;
     turnCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    maxTurns: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    maxTurns: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+    timeoutMs: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
     currentSpeaker: import("@langchain/langgraph").BaseChannel<"source" | "candidate", "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate">, unknown>;
     lastTurn: import("@langchain/langgraph").BaseChannel<{
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | null, {
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | import("@langchain/langgraph").OverwriteValue<{
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | null> | null, unknown>;
-    status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_external" | "completed", "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed">, unknown>;
-    yieldForExternal: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_agent" | "completed", "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed">, unknown>;
     outcome: import("@langchain/langgraph").BaseChannel<{
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | null, {
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | import("@langchain/langgraph").OverwriteValue<{
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | null> | null, unknown>;
     error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
 }, {
@@ -662,75 +636,74 @@ export declare function createDefaultNegotiationGraph(deps: {
         prompt: string;
     }>, unknown>;
     seedAssessment: import("@langchain/langgraph").BaseChannel<SeedAssessment, SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment>, unknown>;
+    discoveryQuery: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    opportunityId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
     conversationId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
     taskId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
     messages: import("@langchain/langgraph").BaseChannel<import("./negotiation.state.js").NegotiationMessage[], import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]>, unknown>;
     turnCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    maxTurns: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    maxTurns: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+    timeoutMs: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
     currentSpeaker: import("@langchain/langgraph").BaseChannel<"source" | "candidate", "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate">, unknown>;
     lastTurn: import("@langchain/langgraph").BaseChannel<{
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | null, {
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | import("@langchain/langgraph").OverwriteValue<{
-        action: "propose" | "accept" | "reject" | "counter";
+        action: "propose" | "accept" | "reject" | "counter" | "question";
         assessment: {
             reasoning: string;
-            fitScore: number;
             suggestedRoles: {
                 ownUser: "agent" | "patient" | "peer";
                 otherUser: "agent" | "patient" | "peer";
             };
         };
+        message?: string | null | undefined;
     } | null> | null, unknown>;
-    status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_external" | "completed", "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed">, unknown>;
-    yieldForExternal: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_agent" | "completed", "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed">, unknown>;
     outcome: import("@langchain/langgraph").BaseChannel<{
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | null, {
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | import("@langchain/langgraph").OverwriteValue<{
         reasoning: string;
         hasOpportunity: boolean;
-        finalScore: number;
         agreedRoles: {
             userId: string;
             role: "agent" | "patient" | "peer";
         }[];
         turnCount: number;
-        reason?: string | undefined;
+        reason?: "timeout" | "turn_cap" | undefined;
     } | null> | null, unknown>;
     error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
 }, import("@langchain/langgraph").StateDefinition, {
@@ -739,6 +712,7 @@ export declare function createDefaultNegotiationGraph(deps: {
         taskId: string;
         currentSpeaker: "source";
         turnCount: number;
+        maxTurns: number;
         error?: undefined;
     } | {
         error: string;
@@ -746,6 +720,7 @@ export declare function createDefaultNegotiationGraph(deps: {
         taskId?: undefined;
         currentSpeaker?: undefined;
         turnCount?: undefined;
+        maxTurns?: undefined;
     };
     turn: import("@langchain/langgraph").UpdateType<{
         sourceUser: import("@langchain/langgraph").BaseChannel<UserNegotiationContext, UserNegotiationContext | import("@langchain/langgraph").OverwriteValue<UserNegotiationContext>, unknown>;
@@ -761,75 +736,74 @@ export declare function createDefaultNegotiationGraph(deps: {
             prompt: string;
         }>, unknown>;
         seedAssessment: import("@langchain/langgraph").BaseChannel<SeedAssessment, SeedAssessment | import("@langchain/langgraph").OverwriteValue<SeedAssessment>, unknown>;
+        discoveryQuery: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        opportunityId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         conversationId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         taskId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         messages: import("@langchain/langgraph").BaseChannel<import("./negotiation.state.js").NegotiationMessage[], import("./negotiation.state.js").NegotiationMessage[] | import("@langchain/langgraph").OverwriteValue<import("./negotiation.state.js").NegotiationMessage[]>, unknown>;
         turnCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        maxTurns: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+        maxTurns: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+        timeoutMs: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
         currentSpeaker: import("@langchain/langgraph").BaseChannel<"source" | "candidate", "source" | "candidate" | import("@langchain/langgraph").OverwriteValue<"source" | "candidate">, unknown>;
         lastTurn: import("@langchain/langgraph").BaseChannel<{
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null, {
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
-            action: "propose" | "accept" | "reject" | "counter";
+            action: "propose" | "accept" | "reject" | "counter" | "question";
             assessment: {
                 reasoning: string;
-                fitScore: number;
                 suggestedRoles: {
                     ownUser: "agent" | "patient" | "peer";
                     otherUser: "agent" | "patient" | "peer";
                 };
             };
+            message?: string | null | undefined;
         } | null> | null, unknown>;
-        status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_external" | "completed", "active" | "waiting_for_external" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_external" | "completed">, unknown>;
-        yieldForExternal: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        status: import("@langchain/langgraph").BaseChannel<"active" | "waiting_for_agent" | "completed", "active" | "waiting_for_agent" | "completed" | import("@langchain/langgraph").OverwriteValue<"active" | "waiting_for_agent" | "completed">, unknown>;
         outcome: import("@langchain/langgraph").BaseChannel<{
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null, {
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | import("@langchain/langgraph").OverwriteValue<{
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         } | null> | null, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
     }>;
@@ -840,16 +814,14 @@ export declare function createDefaultNegotiationGraph(deps: {
         outcome: {
             reasoning: string;
             hasOpportunity: boolean;
-            finalScore: number;
             agreedRoles: {
                 userId: string;
                 role: "agent" | "patient" | "peer";
             }[];
             turnCount: number;
-            reason?: string | undefined;
+            reason?: "timeout" | "turn_cap" | undefined;
         };
         status: "completed";
     };
 }, unknown, unknown>;
-export {};
 //# sourceMappingURL=negotiation.graph.d.ts.map