@indexnetwork/protocol 66.0.0-rc.632.1 → 66.0.0-rc.637.1

package/dist/index.d.ts

@@ -27,6 +27,8 @@ export { decideNegotiationOpening, decideNegotiationTurn, observeNegotiation, ne
 export type { NegotiationAction, NegotiationOutcome, NegotiationTurn, NegotiationState, NegotiationDecision, NegotiationRejection, NegotiationOpening, NegotiationOpeningDecision } from './protocol/negotiation.rules.js';
 export type { NegotiationDatabase } from './platform/database/negotiation.js';
 export { Networks } from "./capabilities/networks.js";
+export { NetworkPulseSummarizer } from "./internal/networks/network.pulse-summarizer.js";
+export type { NetworkPulseSummary, NetworkPulseSummaryInput } from "./internal/networks/network.pulse-summarizer.js";
 export type { NetworksDeps } from "./capabilities/networks.js";
 export { Intents } from "./capabilities/intents.js";
 export type { PrepareAnswer, PrepareInput, PrepareResult, RecoveryField, RecoveryFieldKind, RecoveryFieldOption, IntentsDeps, IntentSemanticMetadata, PreparedIntent, } from "./capabilities/intents.js";

package/dist/index.js

@@ -31,6 +31,7 @@ export { decideNegotiationOpening, decideNegotiationTurn, observeNegotiation, ne
 // The whole capability behind one class: the community lifecycle graph, the
 // membership graph, and signal assignment.
 export { Networks } from "./capabilities/networks.js";
+export { NetworkPulseSummarizer } from "./internal/networks/network.pulse-summarizer.js";
 // ─── Intents ──────────────────────────────────────────────────────────────────
 // The whole capability behind one class: lifecycle graph, verification, and
 // payload preparation.

package/dist/internal/networks/network.pulse-summarizer.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export declare const NetworkPulseSummaryOutputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    negotiations: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    negotiations: string;
+}, {
+    summary: string;
+    negotiations: string;
+}>;
+export type NetworkPulseSummaryOutput = z.infer<typeof NetworkPulseSummaryOutputSchema>;
+export interface NetworkPulseSummaryInput {
+    networkTitle: string;
+    /** Recent open signals in the network, newest first, as members wrote them. */
+    signals: string[];
+    /** Recent negotiations: the two signals each pair of agents is weighing. */
+    negotiations?: Array<{
+        a: string;
+        b: string;
+    }>;
+}
+/** What the invite page shows of the room; either part may be absent. */
+export interface NetworkPulseSummary {
+    summary: string | null;
+    negotiations: string | null;
+}
+/**
+ * Writes the anonymous "what people are looking for" overview for a network's
+ * public invite page. Follows the shared agent pattern: structured output,
+ * `invokeWithAbortSignal`, null on error.
+ */
+export declare class NetworkPulseSummarizer {
+    private model;
+    constructor();
+    /**
+     * @param input - The network's title, its recent open signals and negotiating pairs.
+     * @returns Both texts (each null when there is nothing suitable), or null when the call fails.
+     */
+    invoke(input: NetworkPulseSummaryInput): Promise<NetworkPulseSummary | null>;
+}

package/dist/internal/networks/network.pulse-summarizer.js

@@ -0,0 +1,113 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { HumanMessage, SystemMessage } from "@langchain/core/messages";
+import { z } from "zod";
+import { log } from "../shared/observability/log.js";
+import { Timed } from "../shared/observability/performance.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
+// ─── Response schema ───────────────────────────────────────────────────────────
+export const NetworkPulseSummaryOutputSchema = z.object({
+    summary: z
+        .string()
+        .describe("Two to four sentences, at most 70 words, on what members are after. Empty string when there is not enough suitable material."),
+    negotiations: z
+        .string()
+        .describe("One or two sentences, at most 45 words, on what the agents are negotiating about right now. Empty string when no pairs are given or none are suitable."),
+});
+// ─── Logger ───────────────────────────────────────────────────────────────────
+const logger = log.lib.from("NetworkPulseSummarizer");
+// ─── System prompt ────────────────────────────────────────────────────────────
+const systemPrompt = `
+You write the "what people are looking for" blurb on a network's public invite page.
+Anyone holding the invite link reads it, including people who are not members.
+
+TASK:
+Read the members' open signals and write a short, clear overview, warm in tone, of what is
+going on inside, so a visitor gets a feel for the room. Group signals into themes, e.g.
+"A few people are looking for cofounders and early hires, others want to meet investors who
+get crypto and AI, and at least one person just wants coffee before the conference."
+
+PRIVACY (strict):
+- Describe themes in aggregate. Never quote a signal or reuse its distinctive wording.
+- No names of people, companies, products, projects, schools, or events.
+- No places more specific than a broad region, no dates, numbers, amounts, links, or handles.
+- Use loose quantities ("a few", "some", "several", "others"). Never "one person" for
+  anything specific enough to point at someone.
+- Leave out entirely anything sexual or romantic, medical, legal, financial distress,
+  religious, political, illegal, hateful, or otherwise sensitive or crude. Do not hint at it.
+
+STYLE:
+- Two to four sentences, at most 70 words. Plain, friendly English.
+- Mostly matter-of-fact: say clearly what kinds of people and asks are in the room. A light
+  touch of warmth is welcome in one phrase (the range of the room, an unexpected neighbour of
+  asks), but no punchlines and nothing at anyone's expense.
+- No emoji, no exclamation marks, no em dashes, no headings or lists.
+- Do not mention signals, agents, Index, or the network's name. Start with the content.
+
+If fewer than three signals are suitable after the rules above, return an empty summary.
+
+NEGOTIATIONS:
+You may also get pairs of signals that two members' agents are negotiating over right now.
+In "negotiations", say in one or two sentences, at most 45 words, what the agents are talking
+about at a very high level: the kind of deal, never its details ("a few are working out
+cofounder intros, others are trading notes on a speaking slot"). Same privacy rules, same
+tone, at most one light touch of humor. Do not invent names for the agents. If no pairs are
+given or none are suitable, return an empty string.
+`;
+// ─── Agent class ──────────────────────────────────────────────────────────────
+/**
+ * Writes the anonymous "what people are looking for" overview for a network's
+ * public invite page. Follows the shared agent pattern: structured output,
+ * `invokeWithAbortSignal`, null on error.
+ */
+export class NetworkPulseSummarizer {
+    constructor() {
+        this.model = createStructuredModel("networkPulseSummarizer", NetworkPulseSummaryOutputSchema, {
+            name: "network_pulse_summary",
+        });
+    }
+    /**
+     * @param input - The network's title, its recent open signals and negotiating pairs.
+     * @returns Both texts (each null when there is nothing suitable), or null when the call fails.
+     */
+    async invoke(input) {
+        const clean = (text) => text.replace(/\s+/g, " ").trim().slice(0, 400);
+        const signals = input.signals.map(clean).filter(Boolean);
+        const pairs = (input.negotiations ?? []).map((p) => ({ a: clean(p.a), b: clean(p.b) })).filter((p) => p.a && p.b);
+        if (signals.length < 3 && pairs.length < 2)
+            return { summary: null, negotiations: null };
+        const prompt = [
+            `## Network\n${input.networkTitle}`,
+            `## Open signals\n${signals.map((s) => `- ${s}`).join("\n") || "(none)"}`,
+            `## Negotiating pairs\n${pairs.map((p) => `- ${p.a}  <->  ${p.b}`).join("\n") || "(none)"}`,
+        ].join("\n\n");
+        try {
+            const result = await invokeWithAbortSignal(this.model, [new SystemMessage(systemPrompt), new HumanMessage(prompt)]);
+            const parsed = NetworkPulseSummaryOutputSchema.safeParse(result);
+            if (!parsed.success) {
+                logger.error("Schema validation failed", { error: parsed.error });
+                return null;
+            }
+            const tidy = (text) => text.replace(/\s+/g, " ").trim() || null;
+            return { summary: tidy(parsed.data.summary), negotiations: tidy(parsed.data.negotiations) };
+        }
+        catch (error) {
+            logger.error("Error during execution", { error });
+            return null;
+        }
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], NetworkPulseSummarizer.prototype, "invoke", null);

package/dist/internal/opportunities/opportunity.cards.d.ts

@@ -60,9 +60,11 @@ export declare function presentOpportunityCard(deps: OpportunityCardsDeps, oppor
 }): Promise<OpportunityCard | null>;
 /**
  * List the viewer's opportunities in the given statuses as presented cards,
- * newest first, one card per counterpart. A not-a-fit (rejected) row never
- * takes that slot from another status for the same person. Cards whose
- * presentation fails are dropped.
+ * one card per counterpart. An accepted row keeps that person's slot over a
+ * newer pending or negotiating one, and a pending row this viewer already
+ * committed to keeps it over a newer unanswered one. Among the same rank,
+ * newest wins. A rejected or expired row never takes the slot from a live
+ * one. Cards whose presentation fails are dropped.
  *
  * @param deps - Database, cache, and presenter.
  * @param input - Viewer, statuses, optional network/intent scope, limit, cache bypass, skeleton mode.

package/dist/internal/opportunities/opportunity.cards.js

@@ -33,6 +33,20 @@ function counterpartUserIds(opportunity, viewerId) {
 function viewerHasCommitted(opportunity, viewerId) {
     return (opportunity.committedActorIds ?? []).includes(viewerId);
 }
+/**
+ * Which row keeps a person's single radar slot.
+ * Accepted first, then a pending row this viewer already committed to,
+ * then other live rows. Rejected and expired never take the slot from those.
+ */
+function counterpartSlotRank(opportunity, viewerId) {
+    if (opportunity.status === 'rejected' || opportunity.status === 'expired')
+        return 3;
+    if (opportunity.status === 'accepted')
+        return 0;
+    if (opportunity.status === 'pending' && viewerHasCommitted(opportunity, viewerId))
+        return 1;
+    return 2;
+}
 function stampViewerCommitted(card, viewerCommitted) {
     return { ...card, viewerCommitted };
 }
@@ -113,9 +127,11 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
 }
 /**
  * List the viewer's opportunities in the given statuses as presented cards,
- * newest first, one card per counterpart. A not-a-fit (rejected) row never
- * takes that slot from another status for the same person. Cards whose
- * presentation fails are dropped.
+ * one card per counterpart. An accepted row keeps that person's slot over a
+ * newer pending or negotiating one, and a pending row this viewer already
+ * committed to keeps it over a newer unanswered one. Among the same rank,
+ * newest wins. A rejected or expired row never takes the slot from a live
+ * one. Cards whose presentation fails are dropped.
  *
  * @param deps - Database, cache, and presenter.
  * @param input - Viewer, statuses, optional network/intent scope, limit, cache bypass, skeleton mode.
@@ -133,9 +149,9 @@ export async function listOpportunityCards(deps, input) {
     const visible = raw
         .filter((opp) => requested.has(opp.status) && canUserSeeOpportunity(opp.actors, opp.status, viewerId))
         .sort((a, b) => {
-        const failed = Number(a.status === 'rejected') - Number(b.status === 'rejected');
-        if (failed !== 0)
-            return failed;
+        const rank = counterpartSlotRank(a, viewerId) - counterpartSlotRank(b, viewerId);
+        if (rank !== 0)
+            return rank;
         return b.createdAt.getTime() - a.createdAt.getTime();
     });
     const seen = new Set();

package/dist/internal/shared/agent/model.config.d.ts

@@ -32,7 +32,7 @@ export interface ModelConfig {
     chatReasoningEffort?: 'low' | 'medium' | 'high';
 }
 /** Per-agent model settings before canonical assignments are applied. */
-declare function getBaseModelConfig(config?: ModelConfig): { [Agent in "intentInferrer" | "intentVerifier" | "intentClarifier" | "profileGenerator" | "opportunityPresenter" | "negotiator" | "negotiationReflector" | "homeCategorizer" | "suggestionGenerator" | "chatTitleGenerator" | "negotiationInsights" | "chatContextSummarizer" | "negotiationSummarizer" | "inviteGenerator" | "userContextGenerator" | "networkRecommender" | "interruptClassifier" | "chat"]: Omit<{
+declare function getBaseModelConfig(config?: ModelConfig): { [Agent in "intentInferrer" | "intentVerifier" | "intentClarifier" | "profileGenerator" | "opportunityPresenter" | "negotiator" | "negotiationReflector" | "homeCategorizer" | "suggestionGenerator" | "chatTitleGenerator" | "negotiationInsights" | "chatContextSummarizer" | "negotiationSummarizer" | "inviteGenerator" | "userContextGenerator" | "networkRecommender" | "networkPulseSummarizer" | "interruptClassifier" | "chat"]: Omit<{
     readonly intentInferrer: {
         readonly model: "google/gemini-3.7-flash";
     };
@@ -99,6 +99,11 @@ declare function getBaseModelConfig(config?: ModelConfig): { [Agent in "intentIn
         readonly temperature: 0.2;
         readonly maxTokens: 512;
     };
+    readonly networkPulseSummarizer: {
+        readonly model: "google/gemini-3.7-flash";
+        readonly temperature: 0.7;
+        readonly maxTokens: 400;
+    };
     readonly interruptClassifier: {
         readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0;

package/dist/internal/shared/agent/model.config.js

@@ -20,6 +20,7 @@ function getBaseModelConfig(config) {
         inviteGenerator: { model: "google/gemini-3.7-flash", temperature: 0.3, maxTokens: 512 },
         userContextGenerator: { model: "google/gemini-3.7-flash", temperature: 0.3, maxTokens: 512 },
         networkRecommender: { model: "google/gemini-3.7-flash", temperature: 0.2, maxTokens: 512 },
+        networkPulseSummarizer: { model: "google/gemini-3.7-flash", temperature: 0.7, maxTokens: 400 },
         interruptClassifier: { model: "google/gemini-3.7-flash", temperature: 0.0, maxTokens: 16 },
         chat: {
             model: "google/gemini-3.7-flash",

package/dist/internal/shared/agent/model.resolver.d.ts

@@ -22,12 +22,13 @@ export declare const CANONICAL_AGENT_MODEL_DEFAULTS: Readonly<{
     readonly inviteGenerator: "google/gemini-3.7-flash";
     readonly userContextGenerator: "google/gemini-3.7-flash";
     readonly networkRecommender: "google/gemini-3.7-flash";
+    readonly networkPulseSummarizer: "google/gemini-3.7-flash";
     readonly interruptClassifier: "google/gemini-3.7-flash";
     readonly chat: "google/gemini-3.7-flash";
 }>;
 export type CanonicalModelAgent = keyof typeof CANONICAL_AGENT_MODEL_DEFAULTS;
 export type CanonicalAllAgentModels = Readonly<Record<CanonicalModelAgent, string>>;
-export declare const CANONICAL_MODEL_AGENTS: readonly ("intentInferrer" | "intentVerifier" | "intentClarifier" | "profileGenerator" | "opportunityPresenter" | "negotiator" | "negotiationReflector" | "homeCategorizer" | "suggestionGenerator" | "chatTitleGenerator" | "negotiationInsights" | "chatContextSummarizer" | "negotiationSummarizer" | "inviteGenerator" | "userContextGenerator" | "networkRecommender" | "interruptClassifier" | "chat")[];
+export declare const CANONICAL_MODEL_AGENTS: readonly ("intentInferrer" | "intentVerifier" | "intentClarifier" | "profileGenerator" | "opportunityPresenter" | "negotiator" | "negotiationReflector" | "homeCategorizer" | "suggestionGenerator" | "chatTitleGenerator" | "negotiationInsights" | "chatContextSummarizer" | "negotiationSummarizer" | "inviteGenerator" | "userContextGenerator" | "networkRecommender" | "networkPulseSummarizer" | "interruptClassifier" | "chat")[];
 export declare function resolveCanonicalAllAgentModels(environment: Readonly<Record<string, string | undefined>>, options?: {
     applyEvalOverrides?: boolean;
 }): CanonicalAllAgentModels;

package/dist/internal/shared/agent/model.resolver.js

@@ -22,6 +22,7 @@ export const CANONICAL_AGENT_MODEL_DEFAULTS = Object.freeze({
     inviteGenerator: "google/gemini-3.7-flash",
     userContextGenerator: "google/gemini-3.7-flash",
     networkRecommender: "google/gemini-3.7-flash",
+    networkPulseSummarizer: "google/gemini-3.7-flash",
     interruptClassifier: "google/gemini-3.7-flash",
     chat: "google/gemini-3.7-flash",
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "66.0.0-rc.632.1",
+  "version": "66.0.0-rc.637.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",