@indexnetwork/protocol 6.6.3-rc.389.1 → 6.6.5-rc.391.1

package/dist/negotiation/negotiation.state.js.map

@@ -1 +1 @@
-{"version":3,"file":"negotiation.state.js","sourceRoot":"/","sources":["negotiation/negotiation.state.ts"],"names":[],"mappings":"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","sourcesContent":["import { Annotation } from \"@langchain/langgraph\";\nimport { z } from \"zod\";\nimport type { NegotiationUserAnswer } from \"../shared/interfaces/database.interface.js\";\nimport type { ScreenDecisionRecord } from \"./negotiation.screen.js\";\nimport type { DeadlockShiftRecord } from \"./negotiation.deadlock.js\";\nimport type { NegotiatorMemoryEntry } from \"./negotiation.memory.js\";\nimport { AskUserPayloadSchema, NEGOTIATION_ACTIONS, type NegotiationProtocolVersion } from \"../shared/schemas/negotiation-state.schema.js\";\n\n/**\n * Zod schema for a single negotiation turn (DataPart payload in A2A message).\n * Accepts the full v1+v2 action union — which subset is valid for a given turn\n * is enforced by the seat-scoped schemas in `negotiation.protocol.ts`.\n */\nexport const NegotiationTurnSchema = z.object({\n  action: z.enum(NEGOTIATION_ACTIONS),\n  assessment: z.object({\n    reasoning: z.string(),\n    suggestedRoles: z.object({\n      ownUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n      otherUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n    }),\n  }),\n  message: z.string().nullable().optional(),\n  /** Present when action is `ask_user` (v2, P3.2). */\n  askUser: AskUserPayloadSchema.nullable().optional(),\n});\n\n/** Restricted v1 turn schema for the system agent (no question action). */\nexport const SystemNegotiationTurnSchema = z.object({\n  action: z.enum([\"propose\", \"accept\", \"reject\", \"counter\"]),\n  assessment: z.object({\n    reasoning: z.string(),\n    suggestedRoles: z.object({\n      ownUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n      otherUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n    }),\n  }),\n  message: z.string().nullable().optional(),\n});\n\n/** v1 turn schema for system agent's final allowed turn (must decide). */\nexport const FinalNegotiationTurnSchema = z.object({\n  action: z.enum([\"accept\", \"reject\"]),\n  assessment: z.object({\n    reasoning: z.string(),\n    suggestedRoles: z.object({\n      ownUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n      otherUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n    }),\n  }),\n  message: z.string().nullable().optional(),\n});\n\nexport type NegotiationTurn = z.infer<typeof NegotiationTurnSchema>;\n\n/** Zod schema for the negotiation outcome (Artifact payload on COMPLETED task). */\nexport const NegotiationOutcomeSchema = z.object({\n  hasOpportunity: z.boolean(),\n  agreedRoles: z.array(z.object({\n    userId: z.string(),\n    role: z.enum([\"agent\", \"patient\", \"peer\"]),\n  })),\n  reasoning: z.string(),\n  turnCount: z.number(),\n  reason: z.enum([\"turn_cap\", \"timeout\", \"screened_out\"]).optional(),\n});\n\nexport type NegotiationOutcome = z.infer<typeof NegotiationOutcomeSchema>;\n\n/** Context each agent receives about its user. */\nexport interface UserNegotiationContext {\n  id: string;\n  intents: Array<{ id: string; title: string; description: string; confidence: number }>;\n  profile: { name?: string; bio?: string; location?: string; interests?: string[]; skills?: string[] };\n}\n\n/** Seed assessment from the evaluator pre-filter. */\nexport interface SeedAssessment {\n  reasoning: string;\n  valencyRole: string;\n  actors?: Array<{ userId: string; role: string }>;\n}\n\n/** Typed interface for a negotiation graph's invoke signature. */\nexport interface NegotiationGraphLike {\n  invoke(input: {\n    sourceUser: UserNegotiationContext;\n    candidateUser: UserNegotiationContext;\n    indexContext: { networkId: string; prompt: string };\n    seedAssessment: Omit<SeedAssessment, \"actors\">;\n    discoveryQuery?: string;\n    opportunityId?: string;\n    /** Exact persisted lifecycle version claimed by this negotiation attempt. */\n    opportunityUpdatedAt?: Date;\n    maxTurns?: number;\n    timeoutMs?: number;\n    /**\n     * The user who holds the initiating seat for this match (v2 client-advocate\n     * protocol). Stamped into task metadata by the init node. When omitted, the\n     * init node resolves it: inherit from the prior task for the same\n     * opportunity → conversation-scoped tie-break → fall back to sourceUser.id.\n     */\n    initiatorUserId?: string;\n  }): Promise<{\n    outcome: NegotiationOutcome | null;\n    messages?: NegotiationMessage[];\n    conversationId?: string;\n    isContinuation?: boolean;\n    priorTurnCount?: number;\n  }>;\n}\n\n/** A2A message record shape (matches messages table). */\nexport interface NegotiationMessage {\n  id: string;\n  senderId: string;\n  role: \"agent\";\n  parts: unknown[];\n  createdAt: Date;\n}\n\n/** LangGraph state annotation for the negotiation graph. */\nexport const NegotiationGraphState = Annotation.Root({\n  sourceUser: Annotation<UserNegotiationContext>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ id: \"\", intents: [], profile: {} }),\n  }),\n  candidateUser: Annotation<UserNegotiationContext>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ id: \"\", intents: [], profile: {} }),\n  }),\n  indexContext: Annotation<{ networkId: string; prompt: string }>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ networkId: \"\", prompt: \"\" }),\n  }),\n  seedAssessment: Annotation<SeedAssessment>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ reasoning: \"\", valencyRole: \"\" }),\n  }),\n\n  /**\n   * Explicit initiator seat for this match (purely additive metadata — no seat\n   * rules attach to it yet). Resolution when unset happens in the init node;\n   * the resolved value is written back to state and into task metadata.\n   */\n  initiatorUserId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** The explicit search query that triggered discovery (if any). */\n  discoveryQuery: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n  /**\n   * Negotiation protocol version for this session's task. Resolved by the\n   * init node: inherited from the prior task on the conversation when one\n   * exists (never re-stamped — a v1 conversation stays v1 mid-flight), else\n   * stamped from `NEGOTIATION_PROTOCOL_VERSION` for genuinely fresh runs.\n   */\n  protocolVersion: Annotation<NegotiationProtocolVersion>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"v1\" as const,\n  }),\n\n  /**\n   * Screen-gate decision for this fresh run (P2.1 shadow mode). Written by the\n   * screen node; null when the gate is off, on continuations, or before the\n   * node runs. Mirrors `tasks.metadata.screenDecision`.\n   */\n  screenDecision: Annotation<ScreenDecisionRecord | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /**\n   * First applied deadlock→bargaining shift in this session (IND-428).\n   * Written by the turn node when the system agent first drafts in the\n   * bargaining stance; used to record the shift exactly once per session.\n   * Internal analytics only — mirrored to `tasks.metadata.deadlockShift`,\n   * never into any turn payload or public projection.\n   */\n  deadlockShift: Annotation<DeadlockShiftRecord | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /**\n   * Per-side negotiator-memory cache (P5.3 read path). Populated lazily the\n   * first time each side's memory is retrieved (screen node for the client,\n   * turn node for the speaker) so a multi-turn session pays for retrieval at\n   * most once per side. `undefined` per side = not yet retrieved; `[]` =\n   * retrieved and empty (flag off / no rows / retrieval failed).\n   */\n  memoryBySide: Annotation<Partial<Record<\"source\" | \"candidate\", NegotiatorMemoryEntry[]>>>({\n    reducer: (curr, next) => ({ ...curr, ...next }),\n    default: () => ({}),\n  }),\n\n  /** Whether this run is continuing a prior conversation with the same pair. */\n  isContinuation: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n  opportunityId: Annotation<string>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"\",\n  }),\n  /** Exact persisted lifecycle version claimed by this negotiation attempt. */\n  opportunityUpdatedAt: Annotation<Date | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n  conversationId: Annotation<string>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"\",\n  }),\n  taskId: Annotation<string>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"\",\n  }),\n  messages: Annotation<NegotiationMessage[]>({\n    reducer: (curr, next) => [...curr, ...(next || [])],\n    default: () => [],\n  }),\n  turnCount: Annotation<number>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 0,\n  }),\n  maxTurns: Annotation<number | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n  /**\n   * Park-window budget in milliseconds. Ambient callers pass `AMBIENT_PARK_WINDOW_MS`\n   * (5 minutes); orchestrator callers pass a shorter window. This annotation default\n   * is a safety net for any caller that omits the field — keep it aligned with\n   * `AMBIENT_PARK_WINDOW_MS` in packages/protocol/src/negotiation/negotiation.tools.ts.\n   * Inlined rather than imported to avoid a state↔tools cycle.\n   */\n  timeoutMs: Annotation<number>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 5 * 60 * 1000,\n  }),\n\n  currentSpeaker: Annotation<\"source\" | \"candidate\">({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"source\" as const,\n  }),\n  lastTurn: Annotation<NegotiationTurn | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /**\n   * Graph status.\n   * - `active` — agents are exchanging turns (default)\n   * - `waiting_for_agent` — graph suspended; awaiting external agent response or timeout\n   * - `input_required` — graph suspended on an `ask_user` pause; awaiting the\n   *   negotiator's own client (answer or 24 h window expiry resumes it)\n   * - `completed` — negotiation finalized (accept/reject/turn-cap/timeout)\n   */\n  status: Annotation<'active' | 'waiting_for_agent' | 'input_required' | 'completed'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'active' as const,\n  }),\n\n  /** Number of turns present in the conversation before this session started. */\n  priorTurnCount: Annotation<number>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 0,\n  }),\n\n  /** User answers collected by the questioner between negotiation sessions. */\n  userAnswers: Annotation<NegotiationUserAnswer[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  outcome: Annotation<NegotiationOutcome | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n  error: Annotation<string | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n});\n"]}
+{"version":3,"file":"negotiation.state.js","sourceRoot":"/","sources":["negotiation/negotiation.state.ts"],"names":[],"mappings":"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","sourcesContent":["import { Annotation } from \"@langchain/langgraph\";\nimport { z } from \"zod\";\nimport type { NegotiationUserAnswer, OpportunityStatus } from \"../shared/interfaces/database.interface.js\";\nimport type { ScreenDecisionRecord } from \"./negotiation.screen.js\";\nimport type { DeadlockShiftRecord } from \"./negotiation.deadlock.js\";\nimport type { NegotiatorMemoryEntry } from \"./negotiation.memory.js\";\nimport { AskUserPayloadSchema, NEGOTIATION_ACTIONS, type NegotiationProtocolVersion } from \"../shared/schemas/negotiation-state.schema.js\";\n\n/**\n * Zod schema for a single negotiation turn (DataPart payload in A2A message).\n * Accepts the full v1+v2 action union — which subset is valid for a given turn\n * is enforced by the seat-scoped schemas in `negotiation.protocol.ts`.\n */\nexport const NegotiationTurnSchema = z.object({\n  action: z.enum(NEGOTIATION_ACTIONS),\n  assessment: z.object({\n    reasoning: z.string(),\n    suggestedRoles: z.object({\n      ownUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n      otherUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n    }),\n  }),\n  message: z.string().nullable().optional(),\n  /** Present when action is `ask_user` (v2, P3.2). */\n  askUser: AskUserPayloadSchema.nullable().optional(),\n});\n\n/** Restricted v1 turn schema for the system agent (no question action). */\nexport const SystemNegotiationTurnSchema = z.object({\n  action: z.enum([\"propose\", \"accept\", \"reject\", \"counter\"]),\n  assessment: z.object({\n    reasoning: z.string(),\n    suggestedRoles: z.object({\n      ownUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n      otherUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n    }),\n  }),\n  message: z.string().nullable().optional(),\n});\n\n/** v1 turn schema for system agent's final allowed turn (must decide). */\nexport const FinalNegotiationTurnSchema = z.object({\n  action: z.enum([\"accept\", \"reject\"]),\n  assessment: z.object({\n    reasoning: z.string(),\n    suggestedRoles: z.object({\n      ownUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n      otherUser: z.enum([\"agent\", \"patient\", \"peer\"]),\n    }),\n  }),\n  message: z.string().nullable().optional(),\n});\n\nexport type NegotiationTurn = z.infer<typeof NegotiationTurnSchema>;\n\n/** Zod schema for the negotiation outcome (Artifact payload on COMPLETED task). */\nexport const NegotiationOutcomeSchema = z.object({\n  hasOpportunity: z.boolean(),\n  agreedRoles: z.array(z.object({\n    userId: z.string(),\n    role: z.enum([\"agent\", \"patient\", \"peer\"]),\n  })),\n  reasoning: z.string(),\n  turnCount: z.number(),\n  reason: z.enum([\"turn_cap\", \"timeout\", \"screened_out\"]).optional(),\n});\n\nexport type NegotiationOutcome = z.infer<typeof NegotiationOutcomeSchema>;\n\n/** Context each agent receives about its user. */\nexport interface UserNegotiationContext {\n  id: string;\n  intents: Array<{ id: string; title: string; description: string; confidence: number }>;\n  profile: { name?: string; bio?: string; location?: string; interests?: string[]; skills?: string[] };\n}\n\n/** Seed assessment from the evaluator pre-filter. */\nexport interface SeedAssessment {\n  reasoning: string;\n  valencyRole: string;\n  actors?: Array<{ userId: string; role: string }>;\n}\n\n/** Typed interface for a negotiation graph's invoke signature. */\nexport interface NegotiationGraphLike {\n  invoke(input: {\n    sourceUser: UserNegotiationContext;\n    candidateUser: UserNegotiationContext;\n    indexContext: { networkId: string; prompt: string };\n    seedAssessment: Omit<SeedAssessment, \"actors\">;\n    discoveryQuery?: string;\n    opportunityId?: string;\n    /** Exact persisted lifecycle state claimed by this negotiation attempt. */\n    opportunityStatus?: OpportunityStatus;\n    opportunityUpdatedAt?: Date;\n    maxTurns?: number;\n    timeoutMs?: number;\n    /**\n     * The user who holds the initiating seat for this match (v2 client-advocate\n     * protocol). Stamped into task metadata by the init node. When omitted, the\n     * init node resolves it: inherit from the prior task for the same\n     * opportunity → conversation-scoped tie-break → fall back to sourceUser.id.\n     */\n    initiatorUserId?: string;\n  }): Promise<{\n    outcome: NegotiationOutcome | null;\n    messages?: NegotiationMessage[];\n    conversationId?: string;\n    isContinuation?: boolean;\n    priorTurnCount?: number;\n  }>;\n}\n\n/** A2A message record shape (matches messages table). */\nexport interface NegotiationMessage {\n  id: string;\n  senderId: string;\n  role: \"agent\";\n  parts: unknown[];\n  createdAt: Date;\n}\n\n/** LangGraph state annotation for the negotiation graph. */\nexport const NegotiationGraphState = Annotation.Root({\n  sourceUser: Annotation<UserNegotiationContext>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ id: \"\", intents: [], profile: {} }),\n  }),\n  candidateUser: Annotation<UserNegotiationContext>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ id: \"\", intents: [], profile: {} }),\n  }),\n  indexContext: Annotation<{ networkId: string; prompt: string }>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ networkId: \"\", prompt: \"\" }),\n  }),\n  seedAssessment: Annotation<SeedAssessment>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({ reasoning: \"\", valencyRole: \"\" }),\n  }),\n\n  /**\n   * Explicit initiator seat for this match (purely additive metadata — no seat\n   * rules attach to it yet). Resolution when unset happens in the init node;\n   * the resolved value is written back to state and into task metadata.\n   */\n  initiatorUserId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** The explicit search query that triggered discovery (if any). */\n  discoveryQuery: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n  /**\n   * Negotiation protocol version for this session's task. Resolved by the\n   * init node: inherited from the prior task on the conversation when one\n   * exists (never re-stamped — a v1 conversation stays v1 mid-flight), else\n   * stamped from `NEGOTIATION_PROTOCOL_VERSION` for genuinely fresh runs.\n   */\n  protocolVersion: Annotation<NegotiationProtocolVersion>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"v1\" as const,\n  }),\n\n  /**\n   * Screen-gate decision for this fresh run (P2.1 shadow mode). Written by the\n   * screen node; null when the gate is off, on continuations, or before the\n   * node runs. Mirrors `tasks.metadata.screenDecision`.\n   */\n  screenDecision: Annotation<ScreenDecisionRecord | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /**\n   * First applied deadlock→bargaining shift in this session (IND-428).\n   * Written by the turn node when the system agent first drafts in the\n   * bargaining stance; used to record the shift exactly once per session.\n   * Internal analytics only — mirrored to `tasks.metadata.deadlockShift`,\n   * never into any turn payload or public projection.\n   */\n  deadlockShift: Annotation<DeadlockShiftRecord | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /**\n   * Per-side negotiator-memory cache (P5.3 read path). Populated lazily the\n   * first time each side's memory is retrieved (screen node for the client,\n   * turn node for the speaker) so a multi-turn session pays for retrieval at\n   * most once per side. `undefined` per side = not yet retrieved; `[]` =\n   * retrieved and empty (flag off / no rows / retrieval failed).\n   */\n  memoryBySide: Annotation<Partial<Record<\"source\" | \"candidate\", NegotiatorMemoryEntry[]>>>({\n    reducer: (curr, next) => ({ ...curr, ...next }),\n    default: () => ({}),\n  }),\n\n  /** Whether this run is continuing a prior conversation with the same pair. */\n  isContinuation: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n  opportunityId: Annotation<string>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"\",\n  }),\n  /** Exact persisted lifecycle state claimed by this negotiation attempt. */\n  opportunityStatus: Annotation<OpportunityStatus | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n  opportunityUpdatedAt: Annotation<Date | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n  conversationId: Annotation<string>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"\",\n  }),\n  taskId: Annotation<string>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"\",\n  }),\n  messages: Annotation<NegotiationMessage[]>({\n    reducer: (curr, next) => [...curr, ...(next || [])],\n    default: () => [],\n  }),\n  turnCount: Annotation<number>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 0,\n  }),\n  maxTurns: Annotation<number | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n  /**\n   * Park-window budget in milliseconds. Ambient callers pass `AMBIENT_PARK_WINDOW_MS`\n   * (5 minutes); orchestrator callers pass a shorter window. This annotation default\n   * is a safety net for any caller that omits the field — keep it aligned with\n   * `AMBIENT_PARK_WINDOW_MS` in packages/protocol/src/negotiation/negotiation.tools.ts.\n   * Inlined rather than imported to avoid a state↔tools cycle.\n   */\n  timeoutMs: Annotation<number>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 5 * 60 * 1000,\n  }),\n\n  currentSpeaker: Annotation<\"source\" | \"candidate\">({\n    reducer: (curr, next) => next ?? curr,\n    default: () => \"source\" as const,\n  }),\n  lastTurn: Annotation<NegotiationTurn | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n\n  /**\n   * Graph status.\n   * - `active` — agents are exchanging turns (default)\n   * - `waiting_for_agent` — graph suspended; awaiting external agent response or timeout\n   * - `input_required` — graph suspended on an `ask_user` pause; awaiting the\n   *   negotiator's own client (answer or 24 h window expiry resumes it)\n   * - `completed` — negotiation finalized (accept/reject/turn-cap/timeout)\n   */\n  status: Annotation<'active' | 'waiting_for_agent' | 'input_required' | 'completed'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'active' as const,\n  }),\n\n  /** Number of turns present in the conversation before this session started. */\n  priorTurnCount: Annotation<number>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 0,\n  }),\n\n  /** User answers collected by the questioner between negotiation sessions. */\n  userAnswers: Annotation<NegotiationUserAnswer[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  outcome: Annotation<NegotiationOutcome | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n  error: Annotation<string | null>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => null,\n  }),\n});\n"]}

package/dist/negotiation/negotiation.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"negotiation.tools.d.ts","sourceRoot":"/","sources":["negotiation/negotiation.tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAY5E;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAiCpD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,4BAg4B5E"}
+{"version":3,"file":"negotiation.tools.d.ts","sourceRoot":"/","sources":["negotiation/negotiation.tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAa5E;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAkKpD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,4BA05B5E"}

package/dist/negotiation/negotiation.tools.js

@@ -35,6 +35,105 @@ function readTaskNetworkId(meta) {
     return null;
 }
 const SCOPE_DENIAL = 'Access denied: this negotiation is not in your bound network scope.';
+const DIRECT_CONVERSATION_EVIDENCE_UNAVAILABLE = 'not_provided';
+/**
+ * Builds additive, lifecycle-explicit narration metadata. Task completion only
+ * means the agents concluded; it never establishes owner acceptance or an H2H
+ * conversation.
+ */
+function buildLifecycleNarration(negotiationStatus, opportunity) {
+    const agentNegotiation = negotiationStatus === 'completed'
+        ? 'concluded'
+        : negotiationStatus === 'active'
+            ? 'in_progress'
+            : negotiationStatus === 'waiting_for_agent'
+                ? 'awaiting_agent'
+                : 'unknown';
+    const common = {
+        agentNegotiation,
+        opportunityStatus: opportunity?.status ?? null,
+        ownerAction: opportunity?.acceptedByOwner ? 'accepted' : 'not_recorded',
+        directConversationEvidence: DIRECT_CONVERSATION_EVIDENCE_UNAVAILABLE,
+    };
+    switch (opportunity?.status) {
+        case 'pending':
+            return {
+                ...common,
+                connectionState: 'potential_match_awaiting_owner_review',
+                lifecycleLabel: negotiationStatus === 'completed'
+                    ? "Agents concluded with a potential match; awaiting the owner's review."
+                    : "A potential match is awaiting the owner's review.",
+            };
+        case 'accepted':
+            return opportunity.acceptedByOwner
+                ? {
+                    ...common,
+                    connectionState: 'owner_accepted',
+                    lifecycleLabel: 'The owner explicitly accepted this opportunity.',
+                }
+                : {
+                    ...common,
+                    connectionState: 'accepted_without_owner_evidence',
+                    lifecycleLabel: 'The opportunity is accepted; this result does not record an owner acceptance.',
+                };
+        case 'rejected':
+            return {
+                ...common,
+                connectionState: 'rejected',
+                lifecycleLabel: 'The opportunity was rejected; no connection was established.',
+            };
+        case 'stalled':
+            return {
+                ...common,
+                connectionState: 'negotiation_stalled',
+                lifecycleLabel: 'The agent negotiation stalled; no connection was established.',
+            };
+        case 'draft':
+            return {
+                ...common,
+                connectionState: 'draft_not_sent',
+                lifecycleLabel: 'The opportunity is still a draft; it has not been sent or accepted.',
+            };
+        case 'expired':
+            return {
+                ...common,
+                connectionState: 'expired',
+                lifecycleLabel: 'The opportunity expired; no connection was established.',
+            };
+        case 'negotiating':
+            return {
+                ...common,
+                connectionState: 'agents_negotiating',
+                lifecycleLabel: 'The agents are still negotiating; no owner decision is recorded.',
+            };
+        case 'latent':
+            return {
+                ...common,
+                connectionState: 'latent',
+                lifecycleLabel: 'The potential match is latent; no owner decision is recorded.',
+            };
+        default:
+            return {
+                ...common,
+                connectionState: 'unknown',
+                lifecycleLabel: negotiationStatus === 'completed'
+                    ? 'The agent negotiation concluded; the current opportunity lifecycle is unavailable.'
+                    : 'The current opportunity lifecycle is unavailable.',
+            };
+    }
+}
+/** Reads lifecycle evidence without making older host adapters mandatory. */
+async function readOpportunityLifecycles(database, opportunityIds, ownerUserId) {
+    if (opportunityIds.length === 0 || !database.getOpportunityLifecyclesForNegotiations)
+        return {};
+    try {
+        return await database.getOpportunityLifecyclesForNegotiations(opportunityIds, ownerUserId);
+    }
+    catch (err) {
+        logger.warn('Failed to load opportunity lifecycle for negotiation narration', { err });
+        return {};
+    }
+}
 /** Extracts the ordered NegotiationTurn list from A2A message data parts. */
 function turnsFromMessages(messages) {
     return messages
@@ -58,7 +157,10 @@ export function createNegotiationTools(defineTool, deps) {
             '**Statuses:**\n' +
             '- `active` — Negotiation is in progress, agents are exchanging turns.\n' +
             '- `waiting_for_agent` — The graph has yielded and is waiting for an agent response (e.g. from the user via respond_to_negotiation) or a timeout.\n' +
-            '- `completed` — Negotiation has concluded (accepted, rejected, or reached turn cap).\n\n' +
+            '- `completed` — The agent negotiation has concluded (agent-side accept/reject, or turn cap). This is not a completed connection or an owner decision.\n\n' +
+            '**Lifecycle narration:** Every result includes additive `lifecycle` fields that distinguish the agent-negotiation state, ' +
+            'current opportunity status, and persisted owner acceptance. Agent-side `accept` means only that agents found a potential match; ' +
+            '`pending` still awaits owner review. `directConversationEvidence` is `not_provided`, so this tool never establishes that an H2H message thread exists.\n\n' +
             '**When to use:** To see ongoing and past negotiations, check which negotiations need attention, ' +
             'or find a negotiation ID for get_negotiation or respond_to_negotiation.',
         querySchema: z.object({
@@ -90,6 +192,11 @@ export function createNegotiationTools(defineTool, deps) {
                         : stateFilter === 'completed' ? 'completed'
                             : undefined;
                 const tasks = await negotiationDatabase.getTasksForUser(context.userId, dbState ? { state: dbState } : undefined);
+                const opportunityIds = [...new Set(tasks
+                        .map((task) => task.metadata?.opportunityId)
+                        .filter((opportunityId) => typeof opportunityId === 'string' && opportunityId.trim().length > 0)
+                        .map((opportunityId) => opportunityId.trim()))];
+                const opportunityLifecycles = await readOpportunityLifecycles(negotiationDatabase, opportunityIds, context.userId);
                 const scopedNetworkId = focusedNetworkId(context);
                 const pinnedIntentId = focusedIntentId(context);
                 const effectiveScope = query.scope ?? (pinnedIntentId ? 'signal' : 'all');
@@ -97,9 +204,7 @@ export function createNegotiationTools(defineTool, deps) {
                     return error('Signal scope requires a pinned intent.');
                 }
                 const signalIntentIdsByOpportunity = effectiveScope === 'signal'
-                    ? await negotiationDatabase.getIntentIdsForOpportunities([...new Set(tasks
-                            .map((task) => task.metadata?.opportunityId)
-                            .filter((opportunityId) => typeof opportunityId === 'string' && opportunityId.trim().length > 0))], context.userId)
+                    ? await negotiationDatabase.getIntentIdsForOpportunities(opportunityIds, context.userId)
                     : null;
                 const scopeMetadata = effectiveScope === 'signal'
                     ? { scope: 'signal', intentId: pinnedIntentId }
@@ -158,7 +263,9 @@ export function createNegotiationTools(defineTool, deps) {
                         isContinuation: meta.isContinuation ?? false,
                         priorTurnCount: meta.priorTurnCount ?? 0,
                         latestAction: lastTurnData?.action ?? null,
+                        latestActionActor: 'agent',
                         latestMessagePreview: lastTurnData?.message ?? null,
+                        lifecycle: buildLifecycleNarration(status, opportunityLifecycles[opportunityId]),
                         createdAt: task.createdAt,
                         updatedAt: task.updatedAt,
                     };
@@ -178,6 +285,7 @@ export function createNegotiationTools(defineTool, deps) {
                             speaker,
                             role: speaker === (isSource ? 'source' : 'candidate') ? 'own' : 'other',
                             action: td?.action ?? 'unknown',
+                            actionActor: 'agent',
                             message: td?.message ?? null,
                         };
                     });
@@ -232,9 +340,12 @@ export function createNegotiationTools(defineTool, deps) {
             'Negotiations are bilateral exchanges where two AI agents negotiate on behalf of users. Each turn contains an action ' +
             '(propose, accept, reject, counter, question), an assessment with reasoning and suggested roles, and an optional message.\n\n' +
             '**Access control:** You must be a party to the negotiation (source or candidate) to view it.\n\n' +
-            '**Statuses:** `active` — in progress. `waiting_for_agent` — waiting for an agent response or timeout. `completed` — concluded.\n\n' +
-            '**When to use:** To review the full negotiation history before responding, to understand why a negotiation was ' +
-            'accepted or rejected, or to see the current state of an active negotiation.\n\n' +
+            '**Statuses:** `active` — in progress. `waiting_for_agent` — waiting for an agent response or timeout. `completed` — the agents concluded, not that the owner accepted or a connection/message thread exists.\n\n' +
+            '**Lifecycle narration:** The additive `lifecycle` object is authoritative for user-facing wording. A turn action of `accept` is agent-side; ' +
+            'only `lifecycle.ownerAction=accepted` records this owner as the human acceptor. `conversationType=agent_negotiation` identifies the returned ' +
+            'conversationId as the A2A negotiation transcript; this result does not provide H2H conversation evidence.\n\n' +
+            '**When to use:** To review the full negotiation history before responding, to understand why the agents ' +
+            'accepted or rejected a potential match, or to see the current state of an active negotiation.\n\n' +
             '**Negotiation-turn-mode usage.** If you are running as a silent background subagent (dispatched by the ' +
             "openclaw runtime's poller in response to a claimed negotiation turn), call this tool FIRST with the " +
             'negotiationId from your task prompt. This returns the current state, both parties\' context, and the ' +
@@ -286,10 +397,12 @@ export function createNegotiationTools(defineTool, deps) {
                         ...(tc.discoveryQuery && { discoveryQuery: tc.discoveryQuery }),
                     };
                 }
-                // Load messages and artifacts
-                const [messages, artifacts] = await Promise.all([
+                const lifecycleOpportunityId = meta.opportunityId?.trim() || undefined;
+                // Load messages, artifacts, and the independently persisted opportunity lifecycle.
+                const [messages, artifacts, opportunityLifecycles] = await Promise.all([
                     negotiationDatabase.getMessagesForConversation(task.conversationId),
                     negotiationDatabase.getArtifactsForTask(task.id),
+                    readOpportunityLifecycles(negotiationDatabase, lifecycleOpportunityId ? [lifecycleOpportunityId] : [], context.userId),
                 ]);
                 // Parse turns from messages (speaker from senderId, not parity —
                 // continuations can start with either side speaking first)
@@ -305,6 +418,7 @@ export function createNegotiationTools(defineTool, deps) {
                         speaker,
                         senderId: m.senderId,
                         action: turnData?.action ?? 'unknown',
+                        actionActor: 'agent',
                         reasoning: turnData?.assessment?.reasoning ?? null,
                         suggestedRoles: turnData?.assessment?.suggestedRoles ?? null,
                         message: turnData?.message ?? null,
@@ -338,6 +452,7 @@ export function createNegotiationTools(defineTool, deps) {
                 return success({
                     id: task.id,
                     conversationId: task.conversationId,
+                    conversationType: 'agent_negotiation',
                     status,
                     role: isSource ? 'source' : 'candidate',
                     seat,
@@ -351,6 +466,7 @@ export function createNegotiationTools(defineTool, deps) {
                     turnsAdded: turnCount - priorTurnCount,
                     turns,
                     outcome,
+                    lifecycle: buildLifecycleNarration(status, lifecycleOpportunityId ? opportunityLifecycles[lifecycleOpportunityId] : undefined),
                     context: negotiationContext,
                     createdAt: task.createdAt,
                     updatedAt: task.updatedAt,