@indexnetwork/protocol 0.1.0

package/dist/agents/negotiation.responder.js

@@ -0,0 +1,71 @@
+import { createModel } from "./model.config.js";
+import { NegotiationTurnSchema } from "../states/negotiation.state.js";
+const SYSTEM_PROMPT = `You are a negotiation agent representing your user in an opportunity matching system.
+Your role is to EVALUATE proposals and PROTECT your user from poor matches.
+
+You will receive:
+- Your user's profile, intents, and context
+- The other user's profile, intents, and context
+- The proposal or counter-proposal from the other agent
+- Full negotiation history
+
+Your job:
+1. Critically evaluate whether this match genuinely serves YOUR user's intents.
+2. Respond with one of:
+   - "accept" — the match is genuinely valuable for your user. Both sides benefit.
+   - "reject" — the match does not serve your user's needs. Explain clearly why.
+   - "counter" — partially convinced but have specific objections. State what's missing or weak.
+
+Rules:
+- Be skeptical. Your job is to protect your user from noise.
+- Don't accept just because the other agent is enthusiastic.
+- Look for concrete intent alignment, not vague overlap.
+- If the other agent addressed your previous objections well, acknowledge it.
+- If their counter didn't address your concerns, reject.
+- Your fitScore should reflect YOUR independent assessment.
+- suggestedRoles: "agent" = can help, "patient" = seeks help, "peer" = mutual benefit.`;
+/**
+ * Negotiation agent that evaluates proposals against its user's interests.
+ * @remarks Uses structured output to produce a NegotiationTurn.
+ */
+export class NegotiationResponder {
+    constructor() {
+        this.model = createModel("negotiationResponder").withStructuredOutput(NegotiationTurnSchema, { name: "negotiation_responder" });
+    }
+    /**
+     * Evaluate a proposal/counter and respond.
+     * @param input - User contexts, seed assessment, and negotiation history
+     * @returns A structured NegotiationTurn (accept/reject/counter)
+     */
+    async invoke(input) {
+        const historyText = input.history
+            .map((t, i) => `Turn ${i + 1}: ${t.action} — fitScore: ${t.assessment.fitScore}, reasoning: ${t.assessment.reasoning}`)
+            .join("\n");
+        const userMessage = `YOUR USER:
+Name: ${input.ownUser.profile.name ?? "Unknown"}
+Bio: ${input.ownUser.profile.bio ?? "N/A"}
+Skills: ${input.ownUser.profile.skills?.join(", ") ?? "N/A"}
+Intents: ${input.ownUser.intents.map((i) => `- ${i.title}: ${i.description} (confidence: ${i.confidence})`).join("\n")}
+
+OTHER USER (proposing the match):
+Name: ${input.otherUser.profile.name ?? "Unknown"}
+Bio: ${input.otherUser.profile.bio ?? "N/A"}
+Skills: ${input.otherUser.profile.skills?.join(", ") ?? "N/A"}
+Intents: ${input.otherUser.intents.map((i) => `- ${i.title}: ${i.description} (confidence: ${i.confidence})`).join("\n")}
+
+INDEX CONTEXT: ${input.indexContext.prompt || "General discovery"}
+
+EVALUATOR PRE-SCREEN: Score ${input.seedAssessment.score}/100 — ${input.seedAssessment.reasoning}
+
+NEGOTIATION HISTORY:
+${historyText}
+
+Evaluate the latest proposal/counter from the other agent. Does this match genuinely serve your user?`;
+        const result = await this.model.invoke([
+            { role: "system", content: SYSTEM_PROMPT },
+            { role: "user", content: userMessage },
+        ]);
+        return result;
+    }
+}
+//# sourceMappingURL=negotiation.responder.js.map

package/dist/agents/negotiation.responder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiation.responder.js","sourceRoot":"","sources":["../../src/agents/negotiation.responder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAA0E,MAAM,gCAAgC,CAAC;AAE/I,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;uFAuBiE,CAAC;AAUxF;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAG/B;QACE,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CACnE,qBAAqB,EACrB,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAClC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,KAAgC;QAC3C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,gBAAgB,CAAC,CAAC,UAAU,CAAC,QAAQ,gBAAgB,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;aACtH,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,WAAW,GAAG;QAChB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS;OACxC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK;UAC/B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK;WAChD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW,iBAAiB,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;QAG9G,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS;OAC1C,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK;UACjC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK;WAClD,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW,iBAAiB,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;iBAEvG,KAAK,CAAC,YAAY,CAAC,MAAM,IAAI,mBAAmB;;8BAEnC,KAAK,CAAC,cAAc,CAAC,KAAK,UAAU,KAAK,CAAC,cAAc,CAAC,SAAS;;;EAG9F,WAAW;;sGAEyF,CAAC;QAEnG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;YAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;SACvC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/agents/opportunity.evaluator.d.ts

@@ -0,0 +1,253 @@
+import type { Runnable } from "@langchain/core/runnables";
+import { z } from "zod";
+import type { Lens } from "./lens.inferrer.js";
+import type { OpportunityStatus } from "../interfaces/database.interface.js";
+declare const OpportunitySchema: z.ZodObject<{
+    reasoning: z.ZodString;
+    score: z.ZodNumber;
+    valencyRole: z.ZodEnum<["Agent", "Patient", "Peer"]>;
+    sourceId: z.ZodString;
+    candidateId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reasoning: string;
+    sourceId: string;
+    score: number;
+    valencyRole: "Agent" | "Patient" | "Peer";
+    candidateId: string;
+}, {
+    reasoning: string;
+    sourceId: string;
+    score: number;
+    valencyRole: "Agent" | "Patient" | "Peer";
+    candidateId: string;
+}>;
+export interface EvaluatorEntity {
+    userId: string;
+    profile: {
+        name?: string;
+        bio?: string;
+        location?: string;
+        interests?: string[];
+        skills?: string[];
+        context?: string;
+    };
+    intents?: Array<{
+        intentId: string;
+        payload: string;
+        summary?: string;
+    }>;
+    indexId: string;
+    ragScore?: number;
+    matchedVia?: string;
+}
+export interface EvaluatorInput {
+    /** The user who triggered discovery (for context, not special treatment). */
+    discovererId: string;
+    /** All relevant entities. In introduction mode, only the people being introduced (no introducer). */
+    entities: EvaluatorEntity[];
+    /** Existing opportunities for deduplication. */
+    existingOpportunities?: string;
+    /** When true, DISCOVERER is the introducer; reasoning and actors must be only among ENTITIES. */
+    introductionMode?: boolean;
+    /** Name of the introducer (for attribution in reasoning when introductionMode is true). */
+    introducerName?: string;
+    /** Optional hint/context from the introducer about why these people should meet. */
+    introductionHint?: string;
+    /** Optional discovery query (e.g. from chat). When set, only suggest opportunities where candidates clearly match this request. */
+    discoveryQuery?: string;
+}
+declare const ActorSchema: z.ZodObject<{
+    userId: z.ZodString;
+    role: z.ZodEnum<["agent", "patient", "peer"]>;
+    intentId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    intentId: string | null;
+    role: "agent" | "patient" | "peer";
+}, {
+    userId: string;
+    intentId: string | null;
+    role: "agent" | "patient" | "peer";
+}>;
+declare const OpportunityWithActorsSchema: z.ZodObject<{
+    reasoning: z.ZodString;
+    score: z.ZodNumber;
+    actors: z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        role: z.ZodEnum<["agent", "patient", "peer"]>;
+        intentId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        intentId: string | null;
+        role: "agent" | "patient" | "peer";
+    }, {
+        userId: string;
+        intentId: string | null;
+        role: "agent" | "patient" | "peer";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    reasoning: string;
+    score: number;
+    actors: {
+        userId: string;
+        intentId: string | null;
+        role: "agent" | "patient" | "peer";
+    }[];
+}, {
+    reasoning: string;
+    score: number;
+    actors: {
+        userId: string;
+        intentId: string | null;
+        role: "agent" | "patient" | "peer";
+    }[];
+}>;
+declare const entityBundleResponseFormat: z.ZodObject<{
+    opportunities: z.ZodArray<z.ZodObject<{
+        reasoning: z.ZodString;
+        score: z.ZodNumber;
+        actors: z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            role: z.ZodEnum<["agent", "patient", "peer"]>;
+            intentId: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userId: string;
+            intentId: string | null;
+            role: "agent" | "patient" | "peer";
+        }, {
+            userId: string;
+            intentId: string | null;
+            role: "agent" | "patient" | "peer";
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        reasoning: string;
+        score: number;
+        actors: {
+            userId: string;
+            intentId: string | null;
+            role: "agent" | "patient" | "peer";
+        }[];
+    }, {
+        reasoning: string;
+        score: number;
+        actors: {
+            userId: string;
+            intentId: string | null;
+            role: "agent" | "patient" | "peer";
+        }[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    opportunities: {
+        reasoning: string;
+        score: number;
+        actors: {
+            userId: string;
+            intentId: string | null;
+            role: "agent" | "patient" | "peer";
+        }[];
+    }[];
+}, {
+    opportunities: {
+        reasoning: string;
+        score: number;
+        actors: {
+            userId: string;
+            intentId: string | null;
+            role: "agent" | "patient" | "peer";
+        }[];
+    }[];
+}>;
+export type EvaluatorActor = z.infer<typeof ActorSchema>;
+export type EvaluatedOpportunityWithActors = z.infer<typeof OpportunityWithActorsSchema>;
+export type EvaluatorOutputBundle = z.infer<typeof entityBundleResponseFormat>;
+type Opportunity = z.infer<typeof OpportunitySchema>;
+export interface CandidateProfile {
+    userId: string;
+    identity?: {
+        name?: string;
+        bio?: string;
+        location?: string;
+    };
+    attributes?: {
+        interests?: string[];
+        skills?: string[];
+    };
+    narrative?: {
+        context?: string;
+    };
+    score?: number;
+}
+interface OpportunityEvaluatorOptions {
+    minScore?: number;
+    limit?: number;
+    hydeDescription?: string;
+    /** Pre-inferred lenses (if not provided, lens inference runs automatically in HyDE graph). */
+    lenses?: Lens[];
+    existingOpportunities?: string;
+    candidates?: CandidateProfile[];
+    filter?: Record<string, unknown>;
+    initialStatus?: OpportunityStatus;
+}
+/** Optional test double for entity-bundle model (avoids live LLM in unit tests). */
+export type OpportunityEvaluatorOptionsConstructor = {
+    entityBundleModel?: Runnable;
+};
+export declare class OpportunityEvaluator {
+    private model;
+    private entityBundleModel;
+    constructor(options?: OpportunityEvaluatorOptionsConstructor);
+    /**
+     * Main Entry Point: Batch analysis of candidates.
+     *
+     * @param sourceProfileContext - The profile context string of the user we are finding opportunities FOR.
+     * @param candidates - List of potential matches to evaluate.
+     * @param options - Config (minScore, valid types, etc).
+     * @returns A sorted list of high-value `Opportunity` objects.
+     */
+    invoke(sourceProfileContext: string, candidates: CandidateProfile[], options: OpportunityEvaluatorOptions): Promise<Opportunity[]>;
+    /**
+     * Analyze a single match pair using the primary Agent model.
+     */
+    private analyzeMatch;
+    /**
+     * Entity-bundle entry point (C3): single LLM call with all entities, returns 0..N opportunities with actors.
+     */
+    invokeEntityBundle(input: EvaluatorInput, options?: {
+        minScore?: number;
+        returnAll?: boolean;
+    }): Promise<EvaluatedOpportunityWithActors[]>;
+    /**
+     * Factory method to expose the agent as a LangChain tool.
+     * Simplified to only accept direct evaluation arguments.
+     * PURE: Does not perform any database lookups.
+     */
+    static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        sourceProfileContext: z.ZodString;
+        candidatesJson: z.ZodOptional<z.ZodString>;
+        minScore: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        sourceProfileContext: string;
+        minScore?: number | undefined;
+        candidatesJson?: string | undefined;
+    }, {
+        sourceProfileContext: string;
+        minScore?: number | undefined;
+        candidatesJson?: string | undefined;
+    }>, {
+        sourceProfileContext: string;
+        minScore?: number | undefined;
+        candidatesJson?: string | undefined;
+    }, {
+        sourceProfileContext: string;
+        minScore?: number | undefined;
+        candidatesJson?: string | undefined;
+    }, {
+        reasoning: string;
+        sourceId: string;
+        score: number;
+        valencyRole: "Agent" | "Patient" | "Peer";
+        candidateId: string;
+    }[], unknown, "opportunity_evaluator">;
+}
+export {};
+//# sourceMappingURL=opportunity.evaluator.d.ts.map

package/dist/agents/opportunity.evaluator.d.ts.map

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