@indexnetwork/protocol 66.0.0-rc.630.1 → 66.0.0-rc.635.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.presentation.d.ts

@@ -19,7 +19,7 @@ export interface UserInfo {
     avatar: string | null;
 }
 /** Cache namespace for opportunity presentation copy. Bump to invalidate copy safety changes. */
-export declare const OPPORTUNITY_PRESENTATION_CACHE_VERSION = "v2";
+export declare const OPPORTUNITY_PRESENTATION_CACHE_VERSION = "v3";
 export declare function buildOpportunityCardCacheKey(opportunityId: string, viewerId: string, focusedViewerIntentId?: string): string;
 export declare function buildApiChatCardPresentationCacheKey(opportunityId: string, viewerId: string): string;
 /**

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

@@ -26,16 +26,18 @@ import { createStructuredModel } from "../shared/agent/model.config.js";
 // ── 1. Presentation cache keys ──
 // ──────────────────────────────────────────────────────────────────────
 /** Cache namespace for opportunity presentation copy. Bump to invalidate copy safety changes. */
-export const OPPORTUNITY_PRESENTATION_CACHE_VERSION = "v2";
+export const OPPORTUNITY_PRESENTATION_CACHE_VERSION = "v3";
 export function buildOpportunityCardCacheKey(opportunityId, viewerId, focusedViewerIntentId) {
     const scope = focusedViewerIntentId ? `:intent:${focusedViewerIntentId}` : "";
-    return `card:${opportunityId}:${viewerId}${scope}`;
+    return `card:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:${opportunityId}:${viewerId}${scope}`;
 }
 export function buildApiChatCardPresentationCacheKey(opportunityId, viewerId) {
     return `chat:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${viewerId}`;
 }
 const LLM_TIMEOUT_MS = 20000;
 const GREETING_DESCRIPTION = "A 2-4 sentence first-person message the viewer could send to the counterpart, in the viewer's voice, referencing what they have in common. Plain prose only — no markdown, no greeting prefix like 'Hey {Name},'. Example body: 'Saw we're both working on regenerative coordination tooling — your post on consent flows resonated. Would love to compare notes if you have time this week.'";
+/** Shown under the person's name on cards and in the morning email, so it carries context, not a button label. */
+const SUGGESTED_ACTION_DESCRIPTION = "One short line (max ~70 chars) on what this connection is about for the viewer: the concrete topic, need, or plan the two share, e.g. 'Coffee in SF on agent verification workflows' or 'Beta-testing your journaling app with her writers circle'. Never open with an instruction or UI verb such as 'Accept', 'Send a message', 'Schedule', 'Connect', 'Reach out', 'Review', or 'Check'; the card's buttons already carry the action.";
 // ──────────────────────────────────────────────────────────────
 // SCHEMA & TYPES
 // ──────────────────────────────────────────────────────────────
@@ -46,7 +48,7 @@ const PresentationSchema = z.object({
     personalizedSummary: z
         .string()
         .describe("2-3 sentence explanation using 'you' language, explaining why this opportunity is specifically valuable for the viewer based on their intents and profile"),
-    suggestedAction: z.string().describe("Brief suggested next step"),
+    suggestedAction: z.string().describe(SUGGESTED_ACTION_DESCRIPTION),
     greeting: z.string().max(500).describe(GREETING_DESCRIPTION),
 });
 const responseFormat = z.object({
@@ -60,9 +62,7 @@ export const CardLLMSchema = z.object({
     personalizedSummary: z
         .string()
         .describe("2-3 sentence explanation in 'you' language for the main card body"),
-    suggestedAction: z
-        .string()
-        .describe("Brief suggested next step (e.g. CTA line)"),
+    suggestedAction: z.string().describe(SUGGESTED_ACTION_DESCRIPTION),
     narratorRemark: z
         .string()
         .max(80)
@@ -82,7 +82,9 @@ const homeCardResponseFormat = z.object({
 const systemPrompt = `
 You are an expert at presenting connection opportunities to users in a way that feels personal and compelling.
 
-Your goal: Given raw context about the viewer (their profile, intents), the other person(s), and why the system matched them, produce a short headline, a personalized summary, and a suggested action.
+Your goal: Given raw context about the viewer (their profile, intents), the other person(s), and why the system matched them, produce a short headline, a personalized summary, and a suggestedAction.
+
+suggestedAction: ${SUGGESTED_ACTION_DESCRIPTION}
 
 Rules:
 1. Address the VIEWER directly using "you" and "your". This is for them.
@@ -104,7 +106,6 @@ Rules:
 - If this is an introduction: mention who introduced them and frame it as a personal recommendation.
 - Headline: one short line that hooks (e.g., "[Name] thinks you should meet [Other]" or "A React expert who needs your design skills").
 - Personalized summary: 2-3 sentences. Why is this opportunity for *them*? If introduced, lead with the introduction.
-- Suggested action: encourage action ("Send a message to start the conversation" or "Share this intro").
 
 **If viewer is "agent":**
 - They are seeing this because someone already reached out.
@@ -112,14 +113,12 @@ Rules:
 - Reference their skills/expertise that make them a match.
 - Headline: what the other person needs that they can provide.
 - Personalized summary: 2-3 sentences. Why someone reached out to them.
-- Suggested action: "Someone is interested in connecting — check their message" or "Review and respond".
 
 **If viewer is "peer":**
 - Mutual opportunity. Reference shared or complementary interests.
 - If this is an introduction: mention who connected them.
 - Headline: the mutual connection angle.
 - Personalized summary: 2-3 sentences. Why this is mutually valuable.
-- Suggested action: "Send an intro to connect" or "Start a conversation".
 `;
 const homeCardSystemPrompt = `
 You are an expert at presenting connection opportunities for an opportunity card.
@@ -127,7 +126,7 @@ You are an expert at presenting connection opportunities for an opportunity card
 Given context about the viewer, the other person, and why they were matched, produce:
 1. headline: one short hook line.
 2. personalizedSummary: 2-3 sentences in "you" language (main body text).
-3. suggestedAction: one brief suggested next step.
+3. suggestedAction: ${SUGGESTED_ACTION_DESCRIPTION}
 4. narratorRemark: one short sentence for the narrator chip (who is suggesting and why; max ~80 chars).
 5. greeting: a 2-4 sentence first-person message the viewer could send to the counterpart. Plain prose, no greeting prefix, no markdown.
 7. mutualIntentsLabel: short subtitle under the other party's name. Examples: "3 mutual intents", "Shared interests", "Aligned goals" — keep it brief. NEVER output "0 mutual intents" or any zero-count label; use a qualitative phrase instead.
@@ -361,7 +360,7 @@ function buildNegotiatingChip(input) {
     return {
         headline: "Agents are talking",
         personalizedSummary: "Your agent is still talking with theirs to see if this connection makes sense. We'll surface the full match as soon as they converge.",
-        suggestedAction: "Check back shortly — no action needed yet.",
+        suggestedAction: "Your agents are still working out the fit",
         narratorRemark,
         mutualIntentsLabel: input.mutualIntentCount && input.mutualIntentCount > 0
             ? `${input.mutualIntentCount} mutual intent${input.mutualIntentCount !== 1 ? "s" : ""}`

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.630.1",
+  "version": "66.0.0-rc.635.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",