@indexnetwork/protocol 66.0.0-rc.650.1 → 66.0.0-rc.651.1

package/dist/capabilities/intents.d.ts

@@ -77,6 +77,8 @@ export declare class Intents {
         sourceId: string | null | undefined;
         networkId: string | undefined;
         networkIds: string[] | undefined;
+        visibility: "networks_only" | "mutuals_only" | undefined;
+        isPrivate: boolean | undefined;
         scopeType: import("../index.js").ScopeType | undefined;
         scopeId: string | undefined;
         activeIntentIds: string[];
@@ -129,6 +131,8 @@ export declare class Intents {
         sourceId?: string | null | undefined;
         networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         networkIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined;
+        visibility?: "networks_only" | "mutuals_only" | import("@langchain/langgraph").OverwriteValue<"networks_only" | "mutuals_only" | undefined> | undefined;
+        isPrivate?: boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined;
         scopeType?: import("../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ScopeType | undefined> | undefined;
         scopeId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         activeIntentIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[]> | undefined;
@@ -230,6 +234,8 @@ export declare class Intents {
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        visibility: import("@langchain/langgraph").BaseChannel<"networks_only" | "mutuals_only" | undefined, "networks_only" | "mutuals_only" | import("@langchain/langgraph").OverwriteValue<"networks_only" | "mutuals_only" | undefined> | undefined, unknown>;
+        isPrivate: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../index.js").ScopeType | undefined, import("../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ScopeType | undefined> | undefined, unknown>;
         scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         activeIntentIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
@@ -352,6 +358,8 @@ export declare class Intents {
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        visibility: import("@langchain/langgraph").BaseChannel<"networks_only" | "mutuals_only" | undefined, "networks_only" | "mutuals_only" | import("@langchain/langgraph").OverwriteValue<"networks_only" | "mutuals_only" | undefined> | undefined, unknown>;
+        isPrivate: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../index.js").ScopeType | undefined, import("../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ScopeType | undefined> | undefined, unknown>;
         scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         activeIntentIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;

package/dist/index.d.ts

@@ -33,6 +33,7 @@ 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";
 export { IntentSuggester } from "./internal/intents/intent.suggester.js";
+export { sideIsInterested, type MutualitySide } from "./internal/intents/intent.mutuality.js";
 export type { IntentSuggestion, IntentSuggestionInput, IntentSuggestions } from "./internal/intents/intent.suggester.js";
 export { normalizeTelegramHandle } from './internal/shared/utils/telegram-handle.js';
 /**

package/dist/index.js

@@ -37,6 +37,7 @@ export { NetworkPulseSummarizer } from "./internal/networks/network.pulse-summar
 // payload preparation.
 export { Intents } from "./capabilities/intents.js";
 export { IntentSuggester } from "./internal/intents/intent.suggester.js";
+export { sideIsInterested } from "./internal/intents/intent.mutuality.js";
 // ─── Agents ───────────────────────────────────────────────────────────────────
 export { normalizeTelegramHandle } from './internal/shared/utils/telegram-handle.js';
 // ─── Opportunity compatibility exports ─────────────────────────────────────

package/dist/internal/intents/graph/intent.graph.d.ts

@@ -35,6 +35,8 @@ export declare class IntentGraphFactory {
         sourceId: string | null | undefined;
         networkId: string | undefined;
         networkIds: string[] | undefined;
+        visibility: "networks_only" | "mutuals_only" | undefined;
+        isPrivate: boolean | undefined;
         scopeType: import("../../../index.js").ScopeType | undefined;
         scopeId: string | undefined;
         activeIntentIds: string[];
@@ -87,6 +89,8 @@ export declare class IntentGraphFactory {
         sourceId?: string | null | undefined;
         networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         networkIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined;
+        visibility?: "networks_only" | "mutuals_only" | import("@langchain/langgraph").OverwriteValue<"networks_only" | "mutuals_only" | undefined> | undefined;
+        isPrivate?: boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined;
         scopeType?: import("../../../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../../../index.js").ScopeType | undefined> | undefined;
         scopeId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         activeIntentIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[]> | undefined;
@@ -188,6 +192,8 @@ export declare class IntentGraphFactory {
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        visibility: import("@langchain/langgraph").BaseChannel<"networks_only" | "mutuals_only" | undefined, "networks_only" | "mutuals_only" | import("@langchain/langgraph").OverwriteValue<"networks_only" | "mutuals_only" | undefined> | undefined, unknown>;
+        isPrivate: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../../../index.js").ScopeType | undefined, import("../../../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../../../index.js").ScopeType | undefined> | undefined, unknown>;
         scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         activeIntentIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
@@ -310,6 +316,8 @@ export declare class IntentGraphFactory {
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        visibility: import("@langchain/langgraph").BaseChannel<"networks_only" | "mutuals_only" | undefined, "networks_only" | "mutuals_only" | import("@langchain/langgraph").OverwriteValue<"networks_only" | "mutuals_only" | undefined> | undefined, unknown>;
+        isPrivate: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../../../index.js").ScopeType | undefined, import("../../../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../../../index.js").ScopeType | undefined> | undefined, unknown>;
         scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         activeIntentIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;

package/dist/internal/intents/graph/intent.graph.execute.js

@@ -41,6 +41,7 @@ export async function executorNode(state, deps) {
                         inferenceType: 'explicit',
                         sourceType: state.sourceType ?? null,
                         sourceId: state.sourceId ?? null,
+                        isPrivate: state.isPrivate ?? false,
                         embedding: flatEmbedding,
                         semanticEntropy: metadata?.semanticEntropy ?? null,
                         referentialAnchor: metadata?.referentialAnchor ?? null,
@@ -241,7 +242,7 @@ async function linkIntentToNetworks(deps, state, intentId) {
     });
     const linked = [];
     for (const networkId of requested) {
-        const outcome = await deps.database.assignIntentToNetworkIfMember(state.userId, intentId, networkId, metadata.finalScore, metadata.metadata);
+        const outcome = await deps.database.assignIntentToNetworkIfMember(state.userId, intentId, networkId, metadata.finalScore, metadata.metadata, state.visibility);
         if (outcome.kind === 'assigned' || outcome.kind === 'already_assigned') {
             linked.push(networkId);
         }

package/dist/internal/intents/graph/intent.graph.state.d.ts

@@ -178,6 +178,10 @@ export declare const IntentGraphState: import("@langchain/langgraph").Annotation
      * nothing is inferred or scored. An empty list creates an unlinked intent.
      */
     networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+    /** Applied to every network this create links. Omitted means networks_only. */
+    visibility: import("@langchain/langgraph").BaseChannel<"networks_only" | "mutuals_only" | undefined, "networks_only" | "mutuals_only" | import("@langchain/langgraph").OverwriteValue<"networks_only" | "mutuals_only" | undefined> | undefined, unknown>;
+    /** Only the owner's agent reads this intent. Skips admission when set on create. */
+    isPrivate: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
     /** Focused request scope type for write-side assignment and follow-up queues. */
     scopeType: import("@langchain/langgraph").BaseChannel<ScopeType | undefined, ScopeType | import("@langchain/langgraph").OverwriteValue<ScopeType | undefined> | undefined, unknown>;
     /** Focused request scope id. When scopeType is `network`, this is the focused network id. */

package/dist/internal/intents/graph/intent.graph.state.js

@@ -86,6 +86,16 @@ export const IntentGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => undefined,
     }),
+    /** Applied to every network this create links. Omitted means networks_only. */
+    visibility: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Only the owner's agent reads this intent. Skips admission when set on create. */
+    isPrivate: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
     /** Focused request scope type for write-side assignment and follow-up queues. */
     scopeType: Annotation({
         reducer: (curr, next) => next ?? curr,

package/dist/internal/intents/intent.mutuality.d.ts

@@ -0,0 +1,12 @@
+/** One side of a mutual check. The other side's private intents never appear here. */
+export interface MutualitySide {
+    statement: string;
+    privateIntents: string[];
+    otherStatement: string;
+}
+/**
+ * Whether one side wants the other, given only that side's statement, its private intents, and the other statement.
+ * @param side - The check input the host built. A future envelope replaces how the host builds it.
+ * @returns True only on an explicit yes.
+ */
+export declare function sideIsInterested(side: MutualitySide): Promise<boolean>;

package/dist/internal/intents/intent.mutuality.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { HumanMessage, SystemMessage } from "@langchain/core/messages";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+const AnswerSchema = z.object({ yes: z.boolean() });
+const SYSTEM = [
+    "You answer one yes-or-no question about two people's intents.",
+    "Yes only when the other statement plainly satisfies this side's statement.",
+    "This side's private intents are rules. If the other statement plainly breaks one, answer no.",
+    "Answer no when it is unclear. Return only the boolean.",
+].join(" ");
+/**
+ * Whether one side wants the other, given only that side's statement, its private intents, and the other statement.
+ * @param side - The check input the host built. A future envelope replaces how the host builds it.
+ * @returns True only on an explicit yes.
+ */
+export async function sideIsInterested(side) {
+    const model = createStructuredModel("intentMutuality", AnswerSchema, { name: "mutuality" });
+    const rules = side.privateIntents.length
+        ? side.privateIntents.map((text) => `- ${text}`).join("\n")
+        : "(none)";
+    const result = await model.invoke([
+        new SystemMessage(SYSTEM),
+        new HumanMessage(`This side wants:\n${side.statement}\n\nThis side's private intents:\n${rules}\n\nThe other side's statement:\n${side.otherStatement}\n\nDoes the other statement satisfy what this side wants?`),
+    ]);
+    return result.yes === true;
+}

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

@@ -32,13 +32,18 @@ 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" | "networkPulseSummarizer" | "interruptClassifier" | "chat"]: Omit<{
+declare function getBaseModelConfig(config?: ModelConfig): { [Agent in "intentInferrer" | "intentVerifier" | "intentMutuality" | "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";
     };
     readonly intentVerifier: {
         readonly model: "google/gemini-2.5-flash";
     };
+    readonly intentMutuality: {
+        readonly model: "google/gemini-2.5-flash";
+        readonly temperature: 0;
+        readonly maxTokens: 32;
+    };
     readonly intentClarifier: {
         readonly model: "google/gemini-2.5-flash";
     };

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

@@ -6,6 +6,7 @@ function getBaseModelConfig(config) {
     const settings = {
         intentInferrer: { model: "google/gemini-3.7-flash" },
         intentVerifier: { model: "google/gemini-2.5-flash" },
+        intentMutuality: { model: "google/gemini-2.5-flash", temperature: 0, maxTokens: 32 },
         intentClarifier: { model: "google/gemini-2.5-flash" },
         profileGenerator: { model: "google/gemini-3.7-flash" },
         opportunityPresenter: { model: "google/gemini-3.7-flash" },

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

@@ -8,6 +8,7 @@
 export declare const CANONICAL_AGENT_MODEL_DEFAULTS: Readonly<{
     readonly intentInferrer: "google/gemini-3.7-flash";
     readonly intentVerifier: "google/gemini-2.5-flash";
+    readonly intentMutuality: "google/gemini-2.5-flash";
     readonly intentClarifier: "google/gemini-2.5-flash";
     readonly profileGenerator: "google/gemini-3.7-flash";
     readonly opportunityPresenter: "google/gemini-3.7-flash";
@@ -28,7 +29,7 @@ export declare const CANONICAL_AGENT_MODEL_DEFAULTS: Readonly<{
 }>;
 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" | "networkPulseSummarizer" | "interruptClassifier" | "chat")[];
+export declare const CANONICAL_MODEL_AGENTS: readonly ("intentInferrer" | "intentVerifier" | "intentMutuality" | "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

@@ -8,6 +8,7 @@
 export const CANONICAL_AGENT_MODEL_DEFAULTS = Object.freeze({
     intentInferrer: "google/gemini-3.7-flash",
     intentVerifier: "google/gemini-2.5-flash",
+    intentMutuality: "google/gemini-2.5-flash",
     intentClarifier: "google/gemini-2.5-flash",
     profileGenerator: "google/gemini-3.7-flash",
     opportunityPresenter: "google/gemini-3.7-flash",

package/dist/platform/database/entities.d.ts

@@ -78,7 +78,7 @@ export interface UserSocial {
 }
 /** Detection metadata recorded when an opportunity is created. */
 export interface OpportunityDetection {
-    source: 'opportunity_graph' | 'chat' | 'cron' | 'member_added' | 'introducer';
+    source: 'opportunity_graph' | 'chat' | 'cron' | 'member_added' | 'introducer' | 'mutual_check';
     createdBy?: Id<'users'> | string;
     createdByName?: string;
     triggeredBy?: Id<'intents'>;
@@ -151,8 +151,8 @@ export interface CreateIntentData {
     summary?: string | null;
     /** Pre-computed embedding vector (optional, will be generated if not provided) */
     embedding?: number[];
-    /** Whether the intent should be hidden from public views */
-    isIncognito?: boolean;
+    /** Only the owner's agent reads this intent. */
+    isPrivate?: boolean;
     /** Network IDs to associate with (optional, uses dynamic scoping if empty) */
     networkIds?: string[];
     /** Client-owned label, stored and returned unchanged */
@@ -189,8 +189,8 @@ export interface UpdateIntentData {
     summary?: string | null;
     /** Updated embedding vector */
     embedding?: number[];
-    /** Updated incognito status */
-    isIncognito?: boolean;
+    /** Updated privacy. A private intent cannot be made public again. */
+    isPrivate?: boolean;
     /** Client-owned label; null clears it */
     sourceType?: string | null;
     /** Client-owned reference; null clears it */
@@ -231,8 +231,8 @@ export interface CreatedIntent {
     payload: string;
     /** Generated or provided summary */
     summary: string | null;
-    /** Incognito status */
-    isIncognito: boolean;
+    /** Whether only the owner's agent reads this intent. */
+    isPrivate: boolean;
     /** Creation timestamp */
     createdAt: Date;
     /** Last update timestamp */

package/dist/platform/database/network-queries.d.ts

@@ -44,13 +44,13 @@ export interface DatabaseNetworkQueries {
     /**
      * Assigns an intent to a network (inserts intent_networks row).
      */
-    assignIntentToNetwork(intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata): Promise<void>;
+    assignIntentToNetwork(intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata, visibility?: 'networks_only' | 'mutuals_only'): Promise<void>;
     /**
      * Atomically assign an owned, non-archived intent only while the exact
      * accepted network membership and network remain active. Implementations
      * hold intent, network, and membership row locks through the insert.
      */
-    assignIntentToNetworkIfMember(userId: string, intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata): Promise<IntentNetworkFinalAssignmentResult>;
+    assignIntentToNetworkIfMember(userId: string, intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata, visibility?: 'networks_only' | 'mutuals_only'): Promise<IntentNetworkFinalAssignmentResult>;
     /**
      * Returns per-network relevancy scores for an intent's network assignments.
      */

package/dist/platform/database/port.d.ts

@@ -77,7 +77,7 @@ export interface UserDatabase {
     /** Associate an intent with networks. */
     associateIntentWithNetworks(intentId: string, networkIds: string[]): Promise<void>;
     /** Assign an intent to a network. */
-    assignIntentToNetwork(intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata): Promise<void>;
+    assignIntentToNetwork(intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata, visibility?: 'networks_only' | 'mutuals_only'): Promise<void>;
     /** Unassign an intent from a network. */
     unassignIntentFromNetwork(intentId: string, networkId: string): Promise<void>;
     /** Get network IDs for an intent. */

package/package.json

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