@indexnetwork/protocol 4.5.0-rc.336.1 → 4.5.0-rc.338.1

package/dist/negotiation/negotiation.reflect.d.ts

@@ -0,0 +1,199 @@
+import { z } from "zod";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+/**
+ * Memory kinds a reflection pass may distill (P5.1 `negotiator_memories.kind`).
+ * Plain text at the DB level (55P04 lesson) — adding kinds is code-only.
+ */
+export declare const NEGOTIATOR_MEMORY_KINDS: readonly ["playbook", "disclosure_rule", "counterparty_dossier", "threshold"];
+export type DistilledMemoryKind = (typeof NEGOTIATOR_MEMORY_KINDS)[number];
+/** Hard ceiling on entries distilled per reflection pass (per side). */
+export declare const MAX_DISTILLED_MEMORIES = 3;
+/**
+ * One distilled memory entry as produced by the reflection LLM. The caller
+ * owns persistence: it resolves `aboutCounterparty` to a `subjectUserId`,
+ * computes the embedding, and attaches provenance `sourceRefs`.
+ */
+export declare const DistilledMemorySchema: z.ZodObject<{
+    kind: z.ZodEnum<["playbook", "disclosure_rule", "counterparty_dossier", "threshold"]>;
+    /** Self-contained operational statement, useful without the transcript. */
+    content: z.ZodString;
+    /** Evidence strength, 0..1. Explicit client statements score high. */
+    confidence: z.ZodNumber;
+    /**
+     * True when the entry is about the counterparty (kind should be
+     * `counterparty_dossier`); false for client-side rules and playbooks.
+     */
+    aboutCounterparty: z.ZodBoolean;
+    /** Turn indexes (0-based, into the provided transcript) evidencing this entry. */
+    turnIndexes: z.ZodDefault<z.ZodArray<z.ZodNumber, "many">>;
+}, "strip", z.ZodTypeAny, {
+    kind: "threshold" | "playbook" | "disclosure_rule" | "counterparty_dossier";
+    confidence: number;
+    content: string;
+    aboutCounterparty: boolean;
+    turnIndexes: number[];
+}, {
+    kind: "threshold" | "playbook" | "disclosure_rule" | "counterparty_dossier";
+    confidence: number;
+    content: string;
+    aboutCounterparty: boolean;
+    turnIndexes?: number[] | undefined;
+}>;
+export type DistilledMemory = z.infer<typeof DistilledMemorySchema>;
+export declare const ReflectionResultSchema: z.ZodObject<{
+    memories: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["playbook", "disclosure_rule", "counterparty_dossier", "threshold"]>;
+        /** Self-contained operational statement, useful without the transcript. */
+        content: z.ZodString;
+        /** Evidence strength, 0..1. Explicit client statements score high. */
+        confidence: z.ZodNumber;
+        /**
+         * True when the entry is about the counterparty (kind should be
+         * `counterparty_dossier`); false for client-side rules and playbooks.
+         */
+        aboutCounterparty: z.ZodBoolean;
+        /** Turn indexes (0-based, into the provided transcript) evidencing this entry. */
+        turnIndexes: z.ZodDefault<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "threshold" | "playbook" | "disclosure_rule" | "counterparty_dossier";
+        confidence: number;
+        content: string;
+        aboutCounterparty: boolean;
+        turnIndexes: number[];
+    }, {
+        kind: "threshold" | "playbook" | "disclosure_rule" | "counterparty_dossier";
+        confidence: number;
+        content: string;
+        aboutCounterparty: boolean;
+        turnIndexes?: number[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    memories: {
+        kind: "threshold" | "playbook" | "disclosure_rule" | "counterparty_dossier";
+        confidence: number;
+        content: string;
+        aboutCounterparty: boolean;
+        turnIndexes: number[];
+    }[];
+}, {
+    memories: {
+        kind: "threshold" | "playbook" | "disclosure_rule" | "counterparty_dossier";
+        confidence: number;
+        content: string;
+        aboutCounterparty: boolean;
+        turnIndexes?: number[] | undefined;
+    }[];
+}>;
+export type ReflectionResult = z.infer<typeof ReflectionResultSchema>;
+/** A transcript row projected into the reflecting client's perspective. */
+export interface ReflectionTranscriptEntry {
+    index: number;
+    speaker: "client" | "counterparty";
+    action: string;
+    message?: string;
+    reasoning?: string;
+}
+export interface NegotiationReflectionInput {
+    /** The user whose negotiator is reflecting (memories land on their agent). */
+    clientUser: {
+        id: string;
+        name?: string;
+        bio?: string;
+    };
+    counterpartyUser: {
+        id: string;
+        name?: string;
+        bio?: string;
+    };
+    /** The client's seat in this negotiation. */
+    seat: "initiator" | "counterparty";
+    outcome: {
+        hasOpportunity: boolean;
+        reasoning: string;
+        turnCount: number;
+    };
+    transcript: ReflectionTranscriptEntry[];
+    /** Network prompt for context (optional). */
+    indexContext?: string;
+}
+export interface ChatReflectionInput {
+    clientUser: {
+        id: string;
+        name?: string;
+    };
+    /** The negotiator DM messages, oldest first. */
+    messages: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+}
+/**
+ * Payload the finalize node hands to the injected {@link ReflectEnqueueFn}.
+ * Carries user display context so the reflect worker never re-loads profiles;
+ * turn history is loaded from the conversation by the worker (payloads stay
+ * small in Redis).
+ */
+export interface NegotiationReflectJobData {
+    negotiationId: string;
+    conversationId: string;
+    opportunityId?: string;
+    sourceUser: {
+        id: string;
+        name?: string;
+        bio?: string;
+    };
+    candidateUser: {
+        id: string;
+        name?: string;
+        bio?: string;
+    };
+    initiatorUserId: string;
+    outcome: {
+        hasOpportunity: boolean;
+        reasoning: string;
+        turnCount: number;
+    };
+}
+/**
+ * Injected enqueue callback for post-negotiation reflection (P5.2). The
+ * protocol package has no BullMQ access — services/api wires this at its
+ * composition roots, exactly like `QuestionerEnqueueFn`. Called fire-and-
+ * forget from the finalize node: a reflection failure must never affect the
+ * negotiation outcome.
+ */
+export type ReflectEnqueueFn = (job: NegotiationReflectJobData) => Promise<void>;
+export interface NegotiationReflectorConfig {
+    /** Hard ceiling on the reflection LLM round-trip, in ms (default 20000). */
+    timeoutMs?: number;
+}
+/**
+ * The memory distiller (P5.2). One structured LLM call per reflection pass,
+ * producing ≤ {@link MAX_DISTILLED_MEMORIES} private memory entries for one
+ * client's negotiator. Throws on LLM/validation failure — callers (the reflect
+ * queue worker) own the swallow-and-log policy, since reflection must never
+ * affect a negotiation outcome.
+ */
+export declare class NegotiationReflector {
+    private readonly timeoutMs;
+    constructor(config?: NegotiationReflectorConfig);
+    /**
+     * Distill memories from a finished negotiation, from one side's perspective.
+     * @throws When the LLM call times out or returns schema-invalid output.
+     */
+    reflectNegotiation(input: NegotiationReflectionInput): Promise<DistilledMemory[]>;
+    /**
+     * Distill stated preferences/corrections from a client ↔ negotiator chat.
+     * @throws When the LLM call times out or returns schema-invalid output.
+     */
+    reflectChat(input: ChatReflectionInput): Promise<DistilledMemory[]>;
+    private distill;
+    /**
+     * Raw structured-model round trip. Split out as a seam so tests can drive
+     * the schema-validation path without a live provider.
+     */
+    protected callModel(model: ReturnType<typeof createStructuredModel>, chatMessages: Array<{
+        role: string;
+        content: string;
+    }>): Promise<unknown>;
+}
+//# sourceMappingURL=negotiation.reflect.d.ts.map

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

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

package/dist/negotiation/negotiation.reflect.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+const reflectLog = protocolLogger("NegotiationReflector");
+/**
+ * Memory kinds a reflection pass may distill (P5.1 `negotiator_memories.kind`).
+ * Plain text at the DB level (55P04 lesson) — adding kinds is code-only.
+ */
+export const NEGOTIATOR_MEMORY_KINDS = [
+    "playbook",
+    "disclosure_rule",
+    "counterparty_dossier",
+    "threshold",
+];
+/** Hard ceiling on entries distilled per reflection pass (per side). */
+export const MAX_DISTILLED_MEMORIES = 3;
+/**
+ * One distilled memory entry as produced by the reflection LLM. The caller
+ * owns persistence: it resolves `aboutCounterparty` to a `subjectUserId`,
+ * computes the embedding, and attaches provenance `sourceRefs`.
+ */
+export const DistilledMemorySchema = z.object({
+    kind: z.enum(NEGOTIATOR_MEMORY_KINDS),
+    /** Self-contained operational statement, useful without the transcript. */
+    content: z.string().min(1),
+    /** Evidence strength, 0..1. Explicit client statements score high. */
+    confidence: z.number().min(0).max(1),
+    /**
+     * True when the entry is about the counterparty (kind should be
+     * `counterparty_dossier`); false for client-side rules and playbooks.
+     */
+    aboutCounterparty: z.boolean(),
+    /** Turn indexes (0-based, into the provided transcript) evidencing this entry. */
+    turnIndexes: z.array(z.number().int().min(0)).default([]),
+});
+export const ReflectionResultSchema = z.object({
+    memories: z.array(DistilledMemorySchema).max(MAX_DISTILLED_MEMORIES),
+});
+const NEGOTIATION_SYSTEM_PROMPT = `You are the private post-negotiation reflection process for {clientName}'s negotiator agent. The negotiation is over; your job is to distill AT MOST ${MAX_DISTILLED_MEMORIES} durable operational memory entries that will make {clientName}'s negotiator better in FUTURE negotiations. These memories are private to {clientName}'s agent — the counterparty never sees them.
+
+Memory kinds:
+- "playbook": a tactic or pattern that worked or failed (e.g. "Opening with the specific shared-interest angle got engagement; generic intros stalled").
+- "disclosure_rule": what {clientName} is or is not willing to share/commit (only when the transcript actually evidences it).
+- "counterparty_dossier": a durable fact about the counterparty useful in future dealings with THEM specifically (set aboutCounterparty=true).
+- "threshold": a concrete boundary observed (e.g. minimum scope, timing constraints, deal-breakers).
+
+Rules:
+- Record ONLY what future negotiations need. No summaries, no play-by-play, no identity facts about {clientName} (their profile already covers those).
+- Every entry MUST cite the transcript turn indexes that evidence it in turnIndexes.
+- Each content string must be self-contained and actionable without the transcript.
+- Set confidence by evidence strength: explicit statements ≈ 0.8-0.9, inferred patterns ≈ 0.4-0.6.
+- aboutCounterparty=true ONLY for counterparty_dossier entries.
+- Return an empty memories array when nothing durable was learned — most short or failed negotiations teach nothing. Do not force entries.`;
+const CHAT_SYSTEM_PROMPT = `You are the private reflection process for {clientName}'s negotiator agent, reviewing a direct chat between {clientName} (the client) and their negotiator. Distill AT MOST ${MAX_DISTILLED_MEMORIES} durable operational memory entries capturing the client's STATED preferences, corrections, and instructions.
+
+Memory kinds:
+- "playbook": how the client wants negotiations approached (style, priorities).
+- "disclosure_rule": what the client said they will or won't share/commit.
+- "threshold": concrete boundaries the client stated (rates, scope, timing, deal-breakers).
+
+Rules:
+- Only distill what the CLIENT stated or clearly confirmed — never invent preferences from the negotiator's own suggestions.
+- Do NOT produce counterparty_dossier entries; this is a client-side conversation. Always set aboutCounterparty=false.
+- Each content string must be self-contained and actionable.
+- turnIndexes cite 0-based indexes into the provided message list.
+- Set confidence by how explicit the client was (direct instruction ≈ 0.9, implied preference ≈ 0.5).
+- Return an empty memories array when the chat contains no durable guidance — casual Q&A usually doesn't.`;
+const DEFAULT_REFLECT_TIMEOUT_MS = 20000;
+/**
+ * The memory distiller (P5.2). One structured LLM call per reflection pass,
+ * producing ≤ {@link MAX_DISTILLED_MEMORIES} private memory entries for one
+ * client's negotiator. Throws on LLM/validation failure — callers (the reflect
+ * queue worker) own the swallow-and-log policy, since reflection must never
+ * affect a negotiation outcome.
+ */
+export class NegotiationReflector {
+    constructor(config) {
+        this.timeoutMs = config?.timeoutMs && Number.isFinite(config.timeoutMs) && config.timeoutMs > 0
+            ? config.timeoutMs
+            : DEFAULT_REFLECT_TIMEOUT_MS;
+    }
+    /**
+     * Distill memories from a finished negotiation, from one side's perspective.
+     * @throws When the LLM call times out or returns schema-invalid output.
+     */
+    async reflectNegotiation(input) {
+        const clientName = input.clientUser.name ?? "the client";
+        const counterpartyName = input.counterpartyUser.name ?? "the counterparty";
+        const systemPrompt = NEGOTIATION_SYSTEM_PROMPT.replace(/{clientName}/g, clientName);
+        const transcriptText = input.transcript.length > 0
+            ? input.transcript.map((t) => {
+                const who = t.speaker === "client" ? `${clientName}'s negotiator` : `${counterpartyName}'s negotiator`;
+                const parts = [`[${t.index}] ${who} → ${t.action}`];
+                if (t.message)
+                    parts.push(`message: ${t.message}`);
+                if (t.reasoning)
+                    parts.push(`reasoning: ${t.reasoning}`);
+                return parts.join("\n  ");
+            }).join("\n")
+            : "(no turns)";
+        const userMessage = `CLIENT: ${clientName}${input.clientUser.bio ? ` — ${input.clientUser.bio}` : ""}
+SEAT: ${input.seat === "initiator" ? "initiator (client's negotiator reached out)" : "counterparty (client's negotiator was reached)"}
+COUNTERPARTY: ${counterpartyName}${input.counterpartyUser.bio ? ` — ${input.counterpartyUser.bio}` : ""}
+${input.indexContext ? `NETWORK CONTEXT: ${input.indexContext}\n` : ""}
+OUTCOME: ${input.outcome.hasOpportunity ? "accepted" : "not accepted"} after ${input.outcome.turnCount} turn(s) — ${input.outcome.reasoning}
+
+TRANSCRIPT:
+${transcriptText}
+
+Distill the durable memories (or return an empty array).`;
+        return this.distill(systemPrompt, userMessage);
+    }
+    /**
+     * Distill stated preferences/corrections from a client ↔ negotiator chat.
+     * @throws When the LLM call times out or returns schema-invalid output.
+     */
+    async reflectChat(input) {
+        const clientName = input.clientUser.name ?? "the client";
+        const systemPrompt = CHAT_SYSTEM_PROMPT.replace(/{clientName}/g, clientName);
+        const chatText = input.messages
+            .map((m, i) => `[${i}] ${m.role === "user" ? clientName : "negotiator"}: ${m.content}`)
+            .join("\n");
+        const userMessage = `CHAT between ${clientName} and their negotiator (oldest first):
+${chatText}
+
+Distill the client's durable guidance (or return an empty array).`;
+        return this.distill(systemPrompt, userMessage);
+    }
+    async distill(systemPrompt, userMessage) {
+        const model = createStructuredModel("negotiationReflector", ReflectionResultSchema, { name: "negotiation_reflector" });
+        const result = await this.callModel(model, [
+            { role: "system", content: systemPrompt },
+            { role: "user", content: userMessage },
+        ]);
+        const parsed = ReflectionResultSchema.safeParse(result);
+        if (!parsed.success) {
+            reflectLog.warn("Reflection output failed schema validation", {
+                issues: parsed.error.issues.map((i) => i.message).slice(0, 3),
+            });
+            throw new Error(`Reflection failed validation: ${parsed.error.issues[0]?.message ?? "unknown"}`);
+        }
+        return parsed.data.memories.slice(0, MAX_DISTILLED_MEMORIES);
+    }
+    /**
+     * Raw structured-model round trip. Split out as a seam so tests can drive
+     * the schema-validation path without a live provider.
+     */
+    async callModel(model, chatMessages) {
+        return invokeWithAbortSignal(model, chatMessages, AbortSignal.timeout(this.timeoutMs));
+    }
+}
+//# sourceMappingURL=negotiation.reflect.js.map

package/dist/negotiation/negotiation.reflect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiation.reflect.js","sourceRoot":"/","sources":["negotiation/negotiation.reflect.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { createStructuredModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\n\nconst reflectLog = protocolLogger(\"NegotiationReflector\");\n\n/**\n * Memory kinds a reflection pass may distill (P5.1 `negotiator_memories.kind`).\n * Plain text at the DB level (55P04 lesson) — adding kinds is code-only.\n */\nexport const NEGOTIATOR_MEMORY_KINDS = [\n  \"playbook\",\n  \"disclosure_rule\",\n  \"counterparty_dossier\",\n  \"threshold\",\n] as const;\n\nexport type DistilledMemoryKind = (typeof NEGOTIATOR_MEMORY_KINDS)[number];\n\n/** Hard ceiling on entries distilled per reflection pass (per side). */\nexport const MAX_DISTILLED_MEMORIES = 3;\n\n/**\n * One distilled memory entry as produced by the reflection LLM. The caller\n * owns persistence: it resolves `aboutCounterparty` to a `subjectUserId`,\n * computes the embedding, and attaches provenance `sourceRefs`.\n */\nexport const DistilledMemorySchema = z.object({\n  kind: z.enum(NEGOTIATOR_MEMORY_KINDS),\n  /** Self-contained operational statement, useful without the transcript. */\n  content: z.string().min(1),\n  /** Evidence strength, 0..1. Explicit client statements score high. */\n  confidence: z.number().min(0).max(1),\n  /**\n   * True when the entry is about the counterparty (kind should be\n   * `counterparty_dossier`); false for client-side rules and playbooks.\n   */\n  aboutCounterparty: z.boolean(),\n  /** Turn indexes (0-based, into the provided transcript) evidencing this entry. */\n  turnIndexes: z.array(z.number().int().min(0)).default([]),\n});\n\nexport type DistilledMemory = z.infer<typeof DistilledMemorySchema>;\n\nexport const ReflectionResultSchema = z.object({\n  memories: z.array(DistilledMemorySchema).max(MAX_DISTILLED_MEMORIES),\n});\n\nexport type ReflectionResult = z.infer<typeof ReflectionResultSchema>;\n\n/** A transcript row projected into the reflecting client's perspective. */\nexport interface ReflectionTranscriptEntry {\n  index: number;\n  speaker: \"client\" | \"counterparty\";\n  action: string;\n  message?: string;\n  reasoning?: string;\n}\n\nexport interface NegotiationReflectionInput {\n  /** The user whose negotiator is reflecting (memories land on their agent). */\n  clientUser: { id: string; name?: string; bio?: string };\n  counterpartyUser: { id: string; name?: string; bio?: string };\n  /** The client's seat in this negotiation. */\n  seat: \"initiator\" | \"counterparty\";\n  outcome: { hasOpportunity: boolean; reasoning: string; turnCount: number };\n  transcript: ReflectionTranscriptEntry[];\n  /** Network prompt for context (optional). */\n  indexContext?: string;\n}\n\nexport interface ChatReflectionInput {\n  clientUser: { id: string; name?: string };\n  /** The negotiator DM messages, oldest first. */\n  messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n}\n\n/**\n * Payload the finalize node hands to the injected {@link ReflectEnqueueFn}.\n * Carries user display context so the reflect worker never re-loads profiles;\n * turn history is loaded from the conversation by the worker (payloads stay\n * small in Redis).\n */\nexport interface NegotiationReflectJobData {\n  negotiationId: string;\n  conversationId: string;\n  opportunityId?: string;\n  sourceUser: { id: string; name?: string; bio?: string };\n  candidateUser: { id: string; name?: string; bio?: string };\n  initiatorUserId: string;\n  outcome: { hasOpportunity: boolean; reasoning: string; turnCount: number };\n}\n\n/**\n * Injected enqueue callback for post-negotiation reflection (P5.2). The\n * protocol package has no BullMQ access — services/api wires this at its\n * composition roots, exactly like `QuestionerEnqueueFn`. Called fire-and-\n * forget from the finalize node: a reflection failure must never affect the\n * negotiation outcome.\n */\nexport type ReflectEnqueueFn = (job: NegotiationReflectJobData) => Promise<void>;\n\nconst NEGOTIATION_SYSTEM_PROMPT = `You are the private post-negotiation reflection process for {clientName}'s negotiator agent. The negotiation is over; your job is to distill AT MOST ${MAX_DISTILLED_MEMORIES} durable operational memory entries that will make {clientName}'s negotiator better in FUTURE negotiations. These memories are private to {clientName}'s agent — the counterparty never sees them.\n\nMemory kinds:\n- \"playbook\": a tactic or pattern that worked or failed (e.g. \"Opening with the specific shared-interest angle got engagement; generic intros stalled\").\n- \"disclosure_rule\": what {clientName} is or is not willing to share/commit (only when the transcript actually evidences it).\n- \"counterparty_dossier\": a durable fact about the counterparty useful in future dealings with THEM specifically (set aboutCounterparty=true).\n- \"threshold\": a concrete boundary observed (e.g. minimum scope, timing constraints, deal-breakers).\n\nRules:\n- Record ONLY what future negotiations need. No summaries, no play-by-play, no identity facts about {clientName} (their profile already covers those).\n- Every entry MUST cite the transcript turn indexes that evidence it in turnIndexes.\n- Each content string must be self-contained and actionable without the transcript.\n- Set confidence by evidence strength: explicit statements ≈ 0.8-0.9, inferred patterns ≈ 0.4-0.6.\n- aboutCounterparty=true ONLY for counterparty_dossier entries.\n- Return an empty memories array when nothing durable was learned — most short or failed negotiations teach nothing. Do not force entries.`;\n\nconst CHAT_SYSTEM_PROMPT = `You are the private reflection process for {clientName}'s negotiator agent, reviewing a direct chat between {clientName} (the client) and their negotiator. Distill AT MOST ${MAX_DISTILLED_MEMORIES} durable operational memory entries capturing the client's STATED preferences, corrections, and instructions.\n\nMemory kinds:\n- \"playbook\": how the client wants negotiations approached (style, priorities).\n- \"disclosure_rule\": what the client said they will or won't share/commit.\n- \"threshold\": concrete boundaries the client stated (rates, scope, timing, deal-breakers).\n\nRules:\n- Only distill what the CLIENT stated or clearly confirmed — never invent preferences from the negotiator's own suggestions.\n- Do NOT produce counterparty_dossier entries; this is a client-side conversation. Always set aboutCounterparty=false.\n- Each content string must be self-contained and actionable.\n- turnIndexes cite 0-based indexes into the provided message list.\n- Set confidence by how explicit the client was (direct instruction ≈ 0.9, implied preference ≈ 0.5).\n- Return an empty memories array when the chat contains no durable guidance — casual Q&A usually doesn't.`;\n\nconst DEFAULT_REFLECT_TIMEOUT_MS = 20_000;\n\nexport interface NegotiationReflectorConfig {\n  /** Hard ceiling on the reflection LLM round-trip, in ms (default 20000). */\n  timeoutMs?: number;\n}\n\n/**\n * The memory distiller (P5.2). One structured LLM call per reflection pass,\n * producing ≤ {@link MAX_DISTILLED_MEMORIES} private memory entries for one\n * client's negotiator. Throws on LLM/validation failure — callers (the reflect\n * queue worker) own the swallow-and-log policy, since reflection must never\n * affect a negotiation outcome.\n */\nexport class NegotiationReflector {\n  private readonly timeoutMs: number;\n\n  constructor(config?: NegotiationReflectorConfig) {\n    this.timeoutMs = config?.timeoutMs && Number.isFinite(config.timeoutMs) && config.timeoutMs > 0\n      ? config.timeoutMs\n      : DEFAULT_REFLECT_TIMEOUT_MS;\n  }\n\n  /**\n   * Distill memories from a finished negotiation, from one side's perspective.\n   * @throws When the LLM call times out or returns schema-invalid output.\n   */\n  async reflectNegotiation(input: NegotiationReflectionInput): Promise<DistilledMemory[]> {\n    const clientName = input.clientUser.name ?? \"the client\";\n    const counterpartyName = input.counterpartyUser.name ?? \"the counterparty\";\n\n    const systemPrompt = NEGOTIATION_SYSTEM_PROMPT.replace(/{clientName}/g, clientName);\n\n    const transcriptText = input.transcript.length > 0\n      ? input.transcript.map((t) => {\n          const who = t.speaker === \"client\" ? `${clientName}'s negotiator` : `${counterpartyName}'s negotiator`;\n          const parts = [`[${t.index}] ${who} → ${t.action}`];\n          if (t.message) parts.push(`message: ${t.message}`);\n          if (t.reasoning) parts.push(`reasoning: ${t.reasoning}`);\n          return parts.join(\"\\n  \");\n        }).join(\"\\n\")\n      : \"(no turns)\";\n\n    const userMessage = `CLIENT: ${clientName}${input.clientUser.bio ? ` — ${input.clientUser.bio}` : \"\"}\nSEAT: ${input.seat === \"initiator\" ? \"initiator (client's negotiator reached out)\" : \"counterparty (client's negotiator was reached)\"}\nCOUNTERPARTY: ${counterpartyName}${input.counterpartyUser.bio ? ` — ${input.counterpartyUser.bio}` : \"\"}\n${input.indexContext ? `NETWORK CONTEXT: ${input.indexContext}\\n` : \"\"}\nOUTCOME: ${input.outcome.hasOpportunity ? \"accepted\" : \"not accepted\"} after ${input.outcome.turnCount} turn(s) — ${input.outcome.reasoning}\n\nTRANSCRIPT:\n${transcriptText}\n\nDistill the durable memories (or return an empty array).`;\n\n    return this.distill(systemPrompt, userMessage);\n  }\n\n  /**\n   * Distill stated preferences/corrections from a client ↔ negotiator chat.\n   * @throws When the LLM call times out or returns schema-invalid output.\n   */\n  async reflectChat(input: ChatReflectionInput): Promise<DistilledMemory[]> {\n    const clientName = input.clientUser.name ?? \"the client\";\n    const systemPrompt = CHAT_SYSTEM_PROMPT.replace(/{clientName}/g, clientName);\n\n    const chatText = input.messages\n      .map((m, i) => `[${i}] ${m.role === \"user\" ? clientName : \"negotiator\"}: ${m.content}`)\n      .join(\"\\n\");\n\n    const userMessage = `CHAT between ${clientName} and their negotiator (oldest first):\n${chatText}\n\nDistill the client's durable guidance (or return an empty array).`;\n\n    return this.distill(systemPrompt, userMessage);\n  }\n\n  private async distill(systemPrompt: string, userMessage: string): Promise<DistilledMemory[]> {\n    const model = createStructuredModel(\"negotiationReflector\", ReflectionResultSchema, { name: \"negotiation_reflector\" });\n\n    const result = await this.callModel(model, [\n      { role: \"system\", content: systemPrompt },\n      { role: \"user\", content: userMessage },\n    ]);\n\n    const parsed = ReflectionResultSchema.safeParse(result);\n    if (!parsed.success) {\n      reflectLog.warn(\"Reflection output failed schema validation\", {\n        issues: parsed.error.issues.map((i) => i.message).slice(0, 3),\n      });\n      throw new Error(`Reflection failed validation: ${parsed.error.issues[0]?.message ?? \"unknown\"}`);\n    }\n    return parsed.data.memories.slice(0, MAX_DISTILLED_MEMORIES);\n  }\n\n  /**\n   * Raw structured-model round trip. Split out as a seam so tests can drive\n   * the schema-validation path without a live provider.\n   */\n  protected async callModel(\n    model: ReturnType<typeof createStructuredModel>,\n    chatMessages: Array<{ role: string; content: string }>,\n  ): Promise<unknown> {\n    return invokeWithAbortSignal(model, chatMessages, AbortSignal.timeout(this.timeoutMs));\n  }\n}\n"]}

package/dist/negotiation/negotiation.screen.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { createStructuredModel } from "../shared/agent/model.config.js";
 import type { UserNegotiationContext, SeedAssessment } from "../shared/schemas/negotiation-state.schema.js";
+import { type NegotiatorMemoryEntry } from "./negotiation.memory.js";
 /**
  * Screen-gate modes (P2.1 — client-advocate protocol).
  *
@@ -38,7 +39,7 @@ export declare const ScreenDecisionSchema: z.ZodObject<{
         counterpartyPremiseFit: z.ZodString;
         /** How the client's intents align with what the counterparty seeks. */
         intentAlignment: z.ZodString;
-        /** Prior-negotiation memory signals. Wired in P5.3 — always absent today. */
+        /** Prior-negotiation memory signals (P5.3). Filled only when negotiator memory was injected into the screen prompt. */
         memoryHints: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
         counterpartyPremiseFit: string;
@@ -97,6 +98,12 @@ export interface NegotiationScreenerInput {
         networkId: string;
         prompt?: string;
     };
+    /**
+     * Retrieved negotiator memories for the client (P5.3 read path). Rendered
+     * as a private prompt section with a memoryHints instruction. Absent/empty
+     * → the prompt is byte-identical to before.
+     */
+    memory?: NegotiatorMemoryEntry[];
 }
 export interface NegotiationScreenerConfig {
     /** Hard ceiling on the screen LLM round-trip, in ms (default 15000). */

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

@@ -1 +1 @@
-{"version":3,"file":"negotiation.screen.d.ts","sourceRoot":"/","sources":["negotiation/negotiation.screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAK5G;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,uCAAwC,CAAC;AAE9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAI5D;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;IAG/B,8EAA8E;;;QAG5E,0EAA0E;;QAE1E,uEAAuE;;QAEvE,6EAA6E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG/E,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,UAAU,EAAE,sBAAsB,CAAC;IACnC,yEAAyE;IACzE,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC/C,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAqBD,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,CAAC,EAAE,yBAAyB;IAM9C;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgDtE;;;OAGG;cACa,SAAS,CACvB,KAAK,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,EAC/C,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACrD,OAAO,CAAC,OAAO,CAAC;CAGpB"}
+{"version":3,"file":"negotiation.screen.d.ts","sourceRoot":"/","sources":["negotiation/negotiation.screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAE5G,OAAO,EAAiC,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIpG;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,uCAAwC,CAAC;AAE9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAI5D;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;IAG/B,8EAA8E;;;QAG5E,0EAA0E;;QAE1E,uEAAuE;;QAEvE,uHAAuH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGzH,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,UAAU,EAAE,sBAAsB,CAAC;IACnC,yEAAyE;IACzE,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC/C,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD;;;;OAIG;IACH,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAqBD,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,CAAC,EAAE,yBAAyB;IAM9C;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC;IAiDtE;;;OAGG;cACa,SAAS,CACvB,KAAK,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,EAC/C,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACrD,OAAO,CAAC,OAAO,CAAC;CAGpB"}

package/dist/negotiation/negotiation.screen.js

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { createStructuredModel } from "../shared/agent/model.config.js";
 import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { renderNegotiatorMemorySection } from "./negotiation.memory.js";
 const screenLog = protocolLogger("NegotiationScreener");
 /**
  * Screen-gate modes (P2.1 — client-advocate protocol).
@@ -44,7 +45,7 @@ export const ScreenDecisionSchema = z.object({
         counterpartyPremiseFit: z.string(),
         /** How the client's intents align with what the counterparty seeks. */
         intentAlignment: z.string(),
-        /** Prior-negotiation memory signals. Wired in P5.3 — always absent today. */
+        /** Prior-negotiation memory signals (P5.3). Filled only when negotiator memory was injected into the screen prompt. */
         memoryHints: z.string().nullable().optional(),
     }),
 });
@@ -60,7 +61,7 @@ Rules:
 {queryRule}
 - Judge concrete intent alignment, not topical adjacency.
 - Fill evidence.counterpartyPremiseFit with what (if anything) in the counterparty's context actually fits, and evidence.intentAlignment with how the intents line up. Be specific; cite the strongest signal either way.
-- Do NOT reference internal system details like scores, pre-screens, or evaluator outputs in reasoning that could be shown to users.`;
+- Do NOT reference internal system details like scores, pre-screens, or evaluator outputs in reasoning that could be shown to users.{negotiatorMemory}`;
 const QUERY_RULE = `- {clientName} explicitly searched for "{discoveryQuery}". This query is the PRIMARY criterion: if the counterparty does not satisfy it, pass — background intents cannot rescue a query mismatch.`;
 const NO_QUERY_RULE = `- No explicit search query: judge against {clientName}'s active intents.`;
 const DEFAULT_SCREEN_TIMEOUT_MS = 15000;
@@ -91,7 +92,8 @@ export class NegotiationScreener {
         const systemPrompt = SYSTEM_PROMPT
             .replace(/{clientName}/g, clientName)
             .replace("{networkContext}", networkContext)
-            .replace("{queryRule}", queryRule);
+            .replace("{queryRule}", queryRule)
+            .replace("{negotiatorMemory}", renderNegotiatorMemorySection(input.memory ?? [], { memoryHintsInstruction: true }));
         const formatIntents = (intents) => intents.length > 0 ? intents.map((i) => `- ${i.title}: ${i.description}`).join("\n") : "- (none)";
         const userMessage = `YOUR CLIENT (${clientName}):
 Bio: ${input.clientUser.profile.bio ?? "N/A"}

package/dist/negotiation/negotiation.screen.js.map

@@ -1 +1 @@
-{"version":3,"file":"negotiation.screen.js","sourceRoot":"/","sources":["negotiation/negotiation.screen.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { createStructuredModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\nimport type { UserNegotiationContext, SeedAssessment } from \"../shared/schemas/negotiation-state.schema.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\n\nconst screenLog = protocolLogger(\"NegotiationScreener\");\n\n/**\n * Screen-gate modes (P2.1 — client-advocate protocol).\n *\n * - `off` — the screen node is skipped entirely; no LLM call, no telemetry.\n * - `shadow` — the screen decision is made and recorded (task metadata +\n *   trace event + log line) but NEVER blocks: every fresh negotiation still\n *   proceeds to the first turn. Used to measure pass rates against observed\n *   reject rates before enforcement.\n * - `enforce` — reserved for P2.2. Until enforcement lands, `enforce` runs\n *   identically to `shadow` (decision recorded, negotiation proceeds) and the\n *   screen node logs a warning that enforcement is not yet implemented.\n */\nexport const NEGOTIATION_SCREEN_MODES = [\"off\", \"shadow\", \"enforce\"] as const;\n\nexport type NegotiationScreenMode = (typeof NEGOTIATION_SCREEN_MODES)[number];\n\n/**\n * Resolve the screen mode from `NEGOTIATION_SCREEN_MODE`.\n *\n * Defaults to `off` when unset or unrecognized — the screen gate is an\n * explicit opt-in flip (same operational pattern as\n * `NEGOTIATION_PROTOCOL_VERSION` / `NEGOTIATOR_CHAT_ENABLED`): code ships\n * inert, the environment turns it on.\n */\nexport function configuredScreenMode(): NegotiationScreenMode {\n  const raw = process.env.NEGOTIATION_SCREEN_MODE;\n  if (raw === \"shadow\" || raw === \"enforce\" || raw === \"off\") return raw;\n  return \"off\";\n}\n\n/**\n * Structured screen decision — the outreach gate's verdict on whether this\n * match is worth the client's name before any turn is exchanged.\n */\nexport const ScreenDecisionSchema = z.object({\n  decision: z.enum([\"reach_out\", \"pass\"]),\n  reasoning: z.string(),\n  /** Suggested opening angle for the outreach turn (only when reaching out). */\n  outreachAngle: z.string().nullable().optional(),\n  evidence: z.object({\n    /** How well the counterparty's context/premises fit the client's need. */\n    counterpartyPremiseFit: z.string(),\n    /** How the client's intents align with what the counterparty seeks. */\n    intentAlignment: z.string(),\n    /** Prior-negotiation memory signals. Wired in P5.3 — always absent today. */\n    memoryHints: z.string().nullable().optional(),\n  }),\n});\n\nexport type ScreenDecision = z.infer<typeof ScreenDecisionSchema>;\n\n/**\n * The record persisted to `tasks.metadata.screenDecision` and returned into\n * graph state. Extends the LLM decision with operational context so pass-rate\n * queries can group by mode and exclude failed-open rows.\n */\nexport interface ScreenDecisionRecord extends ScreenDecision {\n  mode: NegotiationScreenMode;\n  /** True when the screen LLM call failed and the gate defaulted open. */\n  failedOpen?: boolean;\n  /** Error message when `failedOpen` is set. */\n  error?: string;\n  screenedAt: string;\n  durationMs: number;\n}\n\nexport interface NegotiationScreenerInput {\n  /** The client — the user whose negotiator is deciding whether to reach out. */\n  clientUser: UserNegotiationContext;\n  /** The counterparty the client's negotiator would be reaching out to. */\n  counterpartyUser: UserNegotiationContext;\n  /** The counterparty's `user_contexts` paragraph (empty string when absent). */\n  counterpartyContext?: string;\n  /** The explicit search query that triggered discovery (if any). */\n  discoveryQuery?: string;\n  seedAssessment: Omit<SeedAssessment, \"actors\">;\n  indexContext: { networkId: string; prompt?: string };\n}\n\nconst SYSTEM_PROMPT = `You are the outreach gate for {clientName}'s negotiator agent on a discovery network. Before any negotiation turn is exchanged, you decide whether this match is worth reaching out to on {clientName}'s behalf — their name and attention are spent with every outreach.\n\nNetwork context: {networkContext}\n\nDecide:\n- \"reach_out\" when the counterparty plausibly serves {clientName}'s stated needs and a concrete, honest opening case can be made. When reaching out, set outreachAngle to the strongest specific angle for the opening message.\n- \"pass\" when the match is generic, one-sided, or rests on vague overlap that would waste both parties' attention.\n\nRules:\n{queryRule}\n- Judge concrete intent alignment, not topical adjacency.\n- Fill evidence.counterpartyPremiseFit with what (if anything) in the counterparty's context actually fits, and evidence.intentAlignment with how the intents line up. Be specific; cite the strongest signal either way.\n- Do NOT reference internal system details like scores, pre-screens, or evaluator outputs in reasoning that could be shown to users.`;\n\nconst QUERY_RULE = `- {clientName} explicitly searched for \"{discoveryQuery}\". This query is the PRIMARY criterion: if the counterparty does not satisfy it, pass — background intents cannot rescue a query mismatch.`;\nconst NO_QUERY_RULE = `- No explicit search query: judge against {clientName}'s active intents.`;\n\nconst DEFAULT_SCREEN_TIMEOUT_MS = 15_000;\n\nexport interface NegotiationScreenerConfig {\n  /** Hard ceiling on the screen LLM round-trip, in ms (default 15000). */\n  timeoutMs?: number;\n}\n\n/**\n * The outreach gate (P2.1). One structured LLM call deciding\n * `reach_out | pass` for a fresh negotiation, from the reaching client's\n * perspective. Throws on LLM/validation failure — the screen graph node owns\n * the fail-open policy (a failed screen never blocks the negotiation).\n */\nexport class NegotiationScreener {\n  private readonly timeoutMs: number;\n\n  constructor(config?: NegotiationScreenerConfig) {\n    this.timeoutMs = config?.timeoutMs && Number.isFinite(config.timeoutMs) && config.timeoutMs > 0\n      ? config.timeoutMs\n      : DEFAULT_SCREEN_TIMEOUT_MS;\n  }\n\n  /**\n   * Produce a screen decision for a fresh match.\n   * @throws When the LLM call times out or returns schema-invalid output.\n   */\n  async invoke(input: NegotiationScreenerInput): Promise<ScreenDecision> {\n    const model = createStructuredModel(\"negotiationScreener\", ScreenDecisionSchema, { name: \"negotiation_screener\" });\n\n    const clientName = input.clientUser.profile.name ?? \"your client\";\n    const counterpartyName = input.counterpartyUser.profile.name ?? \"the counterparty\";\n    const networkContext = input.indexContext.prompt || \"General discovery\";\n    const queryRule = (input.discoveryQuery ? QUERY_RULE : NO_QUERY_RULE)\n      .replace(/{clientName}/g, clientName)\n      .replace(/{discoveryQuery}/g, input.discoveryQuery ?? \"\");\n\n    const systemPrompt = SYSTEM_PROMPT\n      .replace(/{clientName}/g, clientName)\n      .replace(\"{networkContext}\", networkContext)\n      .replace(\"{queryRule}\", queryRule);\n\n    const formatIntents = (intents: UserNegotiationContext[\"intents\"]): string =>\n      intents.length > 0 ? intents.map((i) => `- ${i.title}: ${i.description}`).join(\"\\n\") : \"- (none)\";\n\n    const userMessage = `YOUR CLIENT (${clientName}):\nBio: ${input.clientUser.profile.bio ?? \"N/A\"}\n${input.discoveryQuery ? `Search query: \"${input.discoveryQuery}\"\\nBackground intents (secondary to the query):` : \"Active intents:\"}\n${formatIntents(input.clientUser.intents)}\n\nCOUNTERPARTY (${counterpartyName}):\nBio: ${input.counterpartyUser.profile.bio ?? \"N/A\"}\n${input.counterpartyContext ? `Context: ${input.counterpartyContext}\\n` : \"\"}Active intents:\n${formatIntents(input.counterpartyUser.intents)}\n\nWhy this match was suggested: ${input.seedAssessment.reasoning}\n\nDecide whether reaching out serves ${clientName}.`;\n\n    const chatMessages = [\n      { role: \"system\", content: systemPrompt },\n      { role: \"user\", content: userMessage },\n    ];\n\n    const result = await this.callModel(model, chatMessages);\n    const parsed = ScreenDecisionSchema.safeParse(result);\n    if (!parsed.success) {\n      screenLog.warn(\"Screen output failed schema validation\", {\n        issues: parsed.error.issues.map((i) => i.message).slice(0, 3),\n      });\n      throw new Error(`Screen decision failed validation: ${parsed.error.issues[0]?.message ?? \"unknown\"}`);\n    }\n    return parsed.data;\n  }\n\n  /**\n   * Raw structured-model round trip. Split out as a seam so tests can drive\n   * the schema-validation and fail-open paths without a live provider.\n   */\n  protected async callModel(\n    model: ReturnType<typeof createStructuredModel>,\n    chatMessages: Array<{ role: string; content: string }>,\n  ): Promise<unknown> {\n    return invokeWithAbortSignal(model, chatMessages, AbortSignal.timeout(this.timeoutMs));\n  }\n}\n"]}
+{"version":3,"file":"negotiation.screen.js","sourceRoot":"/","sources":["negotiation/negotiation.screen.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { createStructuredModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\nimport type { UserNegotiationContext, SeedAssessment } from \"../shared/schemas/negotiation-state.schema.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { renderNegotiatorMemorySection, type NegotiatorMemoryEntry } from \"./negotiation.memory.js\";\n\nconst screenLog = protocolLogger(\"NegotiationScreener\");\n\n/**\n * Screen-gate modes (P2.1 — client-advocate protocol).\n *\n * - `off` — the screen node is skipped entirely; no LLM call, no telemetry.\n * - `shadow` — the screen decision is made and recorded (task metadata +\n *   trace event + log line) but NEVER blocks: every fresh negotiation still\n *   proceeds to the first turn. Used to measure pass rates against observed\n *   reject rates before enforcement.\n * - `enforce` — reserved for P2.2. Until enforcement lands, `enforce` runs\n *   identically to `shadow` (decision recorded, negotiation proceeds) and the\n *   screen node logs a warning that enforcement is not yet implemented.\n */\nexport const NEGOTIATION_SCREEN_MODES = [\"off\", \"shadow\", \"enforce\"] as const;\n\nexport type NegotiationScreenMode = (typeof NEGOTIATION_SCREEN_MODES)[number];\n\n/**\n * Resolve the screen mode from `NEGOTIATION_SCREEN_MODE`.\n *\n * Defaults to `off` when unset or unrecognized — the screen gate is an\n * explicit opt-in flip (same operational pattern as\n * `NEGOTIATION_PROTOCOL_VERSION` / `NEGOTIATOR_CHAT_ENABLED`): code ships\n * inert, the environment turns it on.\n */\nexport function configuredScreenMode(): NegotiationScreenMode {\n  const raw = process.env.NEGOTIATION_SCREEN_MODE;\n  if (raw === \"shadow\" || raw === \"enforce\" || raw === \"off\") return raw;\n  return \"off\";\n}\n\n/**\n * Structured screen decision — the outreach gate's verdict on whether this\n * match is worth the client's name before any turn is exchanged.\n */\nexport const ScreenDecisionSchema = z.object({\n  decision: z.enum([\"reach_out\", \"pass\"]),\n  reasoning: z.string(),\n  /** Suggested opening angle for the outreach turn (only when reaching out). */\n  outreachAngle: z.string().nullable().optional(),\n  evidence: z.object({\n    /** How well the counterparty's context/premises fit the client's need. */\n    counterpartyPremiseFit: z.string(),\n    /** How the client's intents align with what the counterparty seeks. */\n    intentAlignment: z.string(),\n    /** Prior-negotiation memory signals (P5.3). Filled only when negotiator memory was injected into the screen prompt. */\n    memoryHints: z.string().nullable().optional(),\n  }),\n});\n\nexport type ScreenDecision = z.infer<typeof ScreenDecisionSchema>;\n\n/**\n * The record persisted to `tasks.metadata.screenDecision` and returned into\n * graph state. Extends the LLM decision with operational context so pass-rate\n * queries can group by mode and exclude failed-open rows.\n */\nexport interface ScreenDecisionRecord extends ScreenDecision {\n  mode: NegotiationScreenMode;\n  /** True when the screen LLM call failed and the gate defaulted open. */\n  failedOpen?: boolean;\n  /** Error message when `failedOpen` is set. */\n  error?: string;\n  screenedAt: string;\n  durationMs: number;\n}\n\nexport interface NegotiationScreenerInput {\n  /** The client — the user whose negotiator is deciding whether to reach out. */\n  clientUser: UserNegotiationContext;\n  /** The counterparty the client's negotiator would be reaching out to. */\n  counterpartyUser: UserNegotiationContext;\n  /** The counterparty's `user_contexts` paragraph (empty string when absent). */\n  counterpartyContext?: string;\n  /** The explicit search query that triggered discovery (if any). */\n  discoveryQuery?: string;\n  seedAssessment: Omit<SeedAssessment, \"actors\">;\n  indexContext: { networkId: string; prompt?: string };\n  /**\n   * Retrieved negotiator memories for the client (P5.3 read path). Rendered\n   * as a private prompt section with a memoryHints instruction. Absent/empty\n   * → the prompt is byte-identical to before.\n   */\n  memory?: NegotiatorMemoryEntry[];\n}\n\nconst SYSTEM_PROMPT = `You are the outreach gate for {clientName}'s negotiator agent on a discovery network. Before any negotiation turn is exchanged, you decide whether this match is worth reaching out to on {clientName}'s behalf — their name and attention are spent with every outreach.\n\nNetwork context: {networkContext}\n\nDecide:\n- \"reach_out\" when the counterparty plausibly serves {clientName}'s stated needs and a concrete, honest opening case can be made. When reaching out, set outreachAngle to the strongest specific angle for the opening message.\n- \"pass\" when the match is generic, one-sided, or rests on vague overlap that would waste both parties' attention.\n\nRules:\n{queryRule}\n- Judge concrete intent alignment, not topical adjacency.\n- Fill evidence.counterpartyPremiseFit with what (if anything) in the counterparty's context actually fits, and evidence.intentAlignment with how the intents line up. Be specific; cite the strongest signal either way.\n- Do NOT reference internal system details like scores, pre-screens, or evaluator outputs in reasoning that could be shown to users.{negotiatorMemory}`;\n\nconst QUERY_RULE = `- {clientName} explicitly searched for \"{discoveryQuery}\". This query is the PRIMARY criterion: if the counterparty does not satisfy it, pass — background intents cannot rescue a query mismatch.`;\nconst NO_QUERY_RULE = `- No explicit search query: judge against {clientName}'s active intents.`;\n\nconst DEFAULT_SCREEN_TIMEOUT_MS = 15_000;\n\nexport interface NegotiationScreenerConfig {\n  /** Hard ceiling on the screen LLM round-trip, in ms (default 15000). */\n  timeoutMs?: number;\n}\n\n/**\n * The outreach gate (P2.1). One structured LLM call deciding\n * `reach_out | pass` for a fresh negotiation, from the reaching client's\n * perspective. Throws on LLM/validation failure — the screen graph node owns\n * the fail-open policy (a failed screen never blocks the negotiation).\n */\nexport class NegotiationScreener {\n  private readonly timeoutMs: number;\n\n  constructor(config?: NegotiationScreenerConfig) {\n    this.timeoutMs = config?.timeoutMs && Number.isFinite(config.timeoutMs) && config.timeoutMs > 0\n      ? config.timeoutMs\n      : DEFAULT_SCREEN_TIMEOUT_MS;\n  }\n\n  /**\n   * Produce a screen decision for a fresh match.\n   * @throws When the LLM call times out or returns schema-invalid output.\n   */\n  async invoke(input: NegotiationScreenerInput): Promise<ScreenDecision> {\n    const model = createStructuredModel(\"negotiationScreener\", ScreenDecisionSchema, { name: \"negotiation_screener\" });\n\n    const clientName = input.clientUser.profile.name ?? \"your client\";\n    const counterpartyName = input.counterpartyUser.profile.name ?? \"the counterparty\";\n    const networkContext = input.indexContext.prompt || \"General discovery\";\n    const queryRule = (input.discoveryQuery ? QUERY_RULE : NO_QUERY_RULE)\n      .replace(/{clientName}/g, clientName)\n      .replace(/{discoveryQuery}/g, input.discoveryQuery ?? \"\");\n\n    const systemPrompt = SYSTEM_PROMPT\n      .replace(/{clientName}/g, clientName)\n      .replace(\"{networkContext}\", networkContext)\n      .replace(\"{queryRule}\", queryRule)\n      .replace(\"{negotiatorMemory}\", renderNegotiatorMemorySection(input.memory ?? [], { memoryHintsInstruction: true }));\n\n    const formatIntents = (intents: UserNegotiationContext[\"intents\"]): string =>\n      intents.length > 0 ? intents.map((i) => `- ${i.title}: ${i.description}`).join(\"\\n\") : \"- (none)\";\n\n    const userMessage = `YOUR CLIENT (${clientName}):\nBio: ${input.clientUser.profile.bio ?? \"N/A\"}\n${input.discoveryQuery ? `Search query: \"${input.discoveryQuery}\"\\nBackground intents (secondary to the query):` : \"Active intents:\"}\n${formatIntents(input.clientUser.intents)}\n\nCOUNTERPARTY (${counterpartyName}):\nBio: ${input.counterpartyUser.profile.bio ?? \"N/A\"}\n${input.counterpartyContext ? `Context: ${input.counterpartyContext}\\n` : \"\"}Active intents:\n${formatIntents(input.counterpartyUser.intents)}\n\nWhy this match was suggested: ${input.seedAssessment.reasoning}\n\nDecide whether reaching out serves ${clientName}.`;\n\n    const chatMessages = [\n      { role: \"system\", content: systemPrompt },\n      { role: \"user\", content: userMessage },\n    ];\n\n    const result = await this.callModel(model, chatMessages);\n    const parsed = ScreenDecisionSchema.safeParse(result);\n    if (!parsed.success) {\n      screenLog.warn(\"Screen output failed schema validation\", {\n        issues: parsed.error.issues.map((i) => i.message).slice(0, 3),\n      });\n      throw new Error(`Screen decision failed validation: ${parsed.error.issues[0]?.message ?? \"unknown\"}`);\n    }\n    return parsed.data;\n  }\n\n  /**\n   * Raw structured-model round trip. Split out as a seam so tests can drive\n   * the schema-validation and fail-open paths without a live provider.\n   */\n  protected async callModel(\n    model: ReturnType<typeof createStructuredModel>,\n    chatMessages: Array<{ role: string; content: string }>,\n  ): Promise<unknown> {\n    return invokeWithAbortSignal(model, chatMessages, AbortSignal.timeout(this.timeoutMs));\n  }\n}\n"]}

package/dist/negotiation/negotiation.state.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import type { NegotiationUserAnswer } from "../shared/interfaces/database.interface.js";
 import type { ScreenDecisionRecord } from "./negotiation.screen.js";
+import type { NegotiatorMemoryEntry } from "./negotiation.memory.js";
 import { type NegotiationProtocolVersion } from "../shared/schemas/negotiation-state.schema.js";
 /**
  * Zod schema for a single negotiation turn (DataPart payload in A2A message).
@@ -311,6 +312,14 @@ export declare const NegotiationGraphState: import("@langchain/langgraph").Annot
      * node runs. Mirrors `tasks.metadata.screenDecision`.
      */
     screenDecision: import("@langchain/langgraph").BaseChannel<ScreenDecisionRecord | null, ScreenDecisionRecord | import("@langchain/langgraph").OverwriteValue<ScreenDecisionRecord | null> | null, unknown>;
+    /**
+     * Per-side negotiator-memory cache (P5.3 read path). Populated lazily the
+     * first time each side's memory is retrieved (screen node for the client,
+     * turn node for the speaker) so a multi-turn session pays for retrieval at
+     * most once per side. `undefined` per side = not yet retrieved; `[]` =
+     * retrieved and empty (flag off / no rows / retrieval failed).
+     */
+    memoryBySide: import("@langchain/langgraph").BaseChannel<Partial<Record<"source" | "candidate", NegotiatorMemoryEntry[]>>, Partial<Record<"source" | "candidate", NegotiatorMemoryEntry[]>> | import("@langchain/langgraph").OverwriteValue<Partial<Record<"source" | "candidate", NegotiatorMemoryEntry[]>>>, unknown>;
     /** Whether this run is continuing a prior conversation with the same pair. */
     isContinuation: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
     opportunityId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;

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

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

package/dist/negotiation/negotiation.state.js

@@ -105,6 +105,17 @@ export const NegotiationGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => null,
     }),
+    /**
+     * Per-side negotiator-memory cache (P5.3 read path). Populated lazily the
+     * first time each side's memory is retrieved (screen node for the client,
+     * turn node for the speaker) so a multi-turn session pays for retrieval at
+     * most once per side. `undefined` per side = not yet retrieved; `[]` =
+     * retrieved and empty (flag off / no rows / retrieval failed).
+     */
+    memoryBySide: Annotation({
+        reducer: (curr, next) => ({ ...curr, ...next }),
+        default: () => ({}),
+    }),
     /** Whether this run is continuing a prior conversation with the same pair. */
     isContinuation: Annotation({
         reducer: (curr, next) => next ?? curr,