@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0

package/dist/shared/interfaces/chat-message-writer.interface.d.ts

@@ -1,18 +0,0 @@
-/**
- * Protocol-side contract for inserting a user message into the user's
- * most-recently-active chat session. The backend implementation finds
- * the session and persists the message via the existing chat-message
- * insertion path.
- */
-export interface ChatMessageWriter {
-    /**
-     * Insert a user message into the user's most-recent chat session.
-     *
-     * @param userId - The owning user
-     * @param content - The flattened user-message text
-     * @returns The sessionId written to, or `null` if the user has no chat session
-     */
-    addUserMessage(userId: string, content: string): Promise<{
-        sessionId: string;
-    } | null>;
-}

package/dist/shared/interfaces/chat-message-writer.interface.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/interfaces/chat-session.interface.d.ts

@@ -1,23 +0,0 @@
-/** One conversation, summarized (no message bodies). */
-export interface ChatSessionSummary {
-    sessionId: string;
-    title: string | null;
-    messageCount: number;
-    lastMessageAt: Date | null;
-    createdAt: Date;
-}
-export interface ChatSessionDetail extends ChatSessionSummary {
-    messages: Array<{
-        role: string;
-        content: string;
-        createdAt: Date;
-    }>;
-}
-export interface ChatSessionReader {
-    getSessionMessages(sessionId: string, limit?: number): Promise<Array<{
-        role: string;
-        content: string;
-    }>>;
-    listSessions(userId: string, limit?: number): Promise<ChatSessionSummary[]>;
-    getSession(userId: string, sessionId: string, messageLimit?: number): Promise<ChatSessionDetail | null>;
-}

package/dist/shared/interfaces/chat-session.interface.js

@@ -1,18 +0,0 @@
-// ═══════════════════════════════════════════════════════════════════════════════
-// Chat session reads
-//
-// Port contract (host application implements):
-//   • Reads only — no method here mutates state.
-//   • `getSession` returns `null` when the session does not exist OR is not owned
-//     by `userId` (ownership is enforced at this boundary, not by the caller).
-//   • `getSessionMessages` / `listSessions` return an empty array (never null) when
-//     there is nothing to return.
-//   • `limit` / `messageLimit`, when provided, cap the most-recent N rows; when
-//     omitted the adapter applies its own sane default.
-//   • Category contract (IND-600): `listSessions` / `getSession` expose ONLY H2A
-//     conversations (orchestrator-persona sessions with the system agent as a
-//     participant). H2H DMs are never exposed through this port, and A2A
-//     negotiation conversations are reachable only through the negotiation
-//     tools; non-H2A session IDs behave exactly like nonexistent ones.
-// ═══════════════════════════════════════════════════════════════════════════════
-export {};

package/dist/shared/interfaces/chat-summary.interface.d.ts

@@ -1,16 +0,0 @@
-/**
- * Protocol-side contract for reading a chat session's current digest. The
- * backend implementation (ChatSummaryService) handles persistence and
- * incremental summarization; the protocol layer only sees this shape.
- */
-import type { ChatContextDigest } from "../schemas/chat-context.schema.js";
-export interface ChatSummaryReader {
-    /**
-     * Returns the freshest digest for the session, running incremental
-     * summarization if there are new messages.
-     *
-     * @returns the digest, or `null` when the session has no messages or
-     *   when summarization fails on a session that has no prior digest.
-     */
-    getDigest(sessionId: string): Promise<ChatContextDigest | null>;
-}

package/dist/shared/interfaces/chat-summary.interface.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/interfaces/database.capabilities.d.ts

@@ -1,100 +0,0 @@
-/**
- * Capability-narrowed views of {@link Database}.
- *
- * Graphs depend on these rather than the whole port so a graph's data reach is
- * visible in one line.
- */
-import type { NegotiationGraphDatabase, NegotiationQueries } from './database.negotiation.js';
-import type { Database } from './database.port.js';
-/**
- * Database interface narrowed for Profile Graph operations.
- * Provides full profile lifecycle: read, write, and query mode.
- *
- * Access layer: Primarily UserDatabase (user's own profile)
- */
-export type EnrichmentGraphDatabase = Pick<Database, 'getProfile' | 'getUser' | 'updateUser' | 'saveProfile' | 'getProfileByUserId' | 'getUserSocials' | 'setUserSocials' | 'getPremisesForUser' | 'getUserContext'> & {
-    /**
-     * Optional premise retraction support. When present, write-mode input that
-     * disavows existing premises ("remove X", "I have nothing to do with Y")
-     * retracts them during decomposition. Adapters without it (e.g. the scraped
-     * enrichment adapter) skip retraction — scraped content never disavows.
-     */
-    updatePremise?: Database['updatePremise'];
-};
-/**
- * Database interface narrowed for Premise Graph operations.
- * Provides premise lifecycle: create, read, update, and network assignment.
- *
- * Access layer: UserDatabase (user's own premises)
- */
-export type PremiseGraphDatabase = Pick<Database, 'createPremise' | 'getPremise' | 'getPremisesForUser' | 'updatePremise' | 'assignPremiseToNetwork' | 'getPremiseNetworks' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkAssignmentContext' | 'getUserIndexIds' | 'getNetwork' | 'getNetworkMemberContext' | 'findSimilarActivePremise'>;
-/**
- * Composite database interface for Chat Graph.
- * Includes direct ChatGraph operations plus all methods needed by
- * internally composed subgraphs (ProfileGraph, OpportunityGraph, IntentGraph, NetworkGraph).
- *
- * Use this type when ChatGraph orchestrates subgraphs internally.
- *
- * Access layer: Both UserDatabase + SystemDatabase (orchestrates all operations)
- */
-export type ChatGraphCompositeDatabase = Pick<Database, 'getProfile' | 'getActiveIntents' | 'getActiveIntentsAcrossIndexes' | 'getIntentsInIndexForMember' | 'getUser' | 'updateUser' | 'getUserSocials' | 'setUserSocials' | 'saveProfile' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction' | 'getOrCreateDM' | 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent' | 'getPublicIndexesNotJoined' | 'getUserIndexIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getActiveNetworkMembershipPairs' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToIndex' | 'assignIntentToNetwork' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromIndex' | 'getNetworkIdsForIntent' | 'getIntentIndexScores' | 'getPersonalIndexesForContact' | 'getOwnedIndexes' | 'isIndexOwner' | 'isNetworkMember' | 'getNetworkMembersForOwner' | 'getNetworkMembersForMember' | 'getMembersFromUserIndexes' | 'getNetworkIntentsForOwner' | 'getNetworkIntentsForMember' | 'updateIndexSettings' | 'softDeleteNetwork' | 'deleteProfile' | 'getProfileByUserId' | 'createNetwork' | 'getNetworkMemberCount' | 'addMemberToNetwork' | 'removeMemberFromIndex' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'createPremise' | 'getPremise' | 'updatePremise' | 'assignPremiseToNetwork' | 'getPremiseNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'searchUserContextsBySimilarity'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
-/**
- * Database interface for Opportunity Graph operations.
- * Includes prep/scope (network membership, intents, index details), persist (create, dedupe),
- * and CRUD operations (read, update status, send).
- *
- * Access layer: SystemDatabase (cross-user opportunity operations)
- */
-export type OpportunityGraphDatabase = Pick<Database, 'getProfile' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getUserIndexIds' | 'getNetworkMemberships' | 'getActiveNetworkMembershipPairs' | 'getActiveIntents' | 'getNetworkIdsForIntent' | 'getNetwork' | 'getNetworkMemberCount' | 'getIntentIndexScores' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getOpportunity' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'stampOpportunityActorAction' | 'updateOpportunityActorApproval' | 'isNetworkMember' | 'isIndexOwner' | 'getUser' | 'getOrCreateDM' | 'getIntent' | 'getPremise' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'searchUserContextsBySimilarity' | 'getHydeDocumentsForSource' | 'getRecentlyRejectedOpportunityCounterparties'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
-export interface OutcomeOutbox {
-    event: unknown;
-    actorResolution: 'selected_intent' | 'unique_owned_scope';
-    result: {
-        inserted: boolean;
-    };
-}
-export type OpportunityControllerDatabase = Pick<Database, 'getOpportunity' | 'getOpportunitiesByIds' | 'findEnrichedReplacementOpportunities' | 'getOpportunitiesForUser' | 'getOpportunitiesForNetwork' | 'resolveOpportunityId' | 'updateOpportunityStatus' | 'createOpportunity' | 'createOpportunityAndExpireIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'acceptSiblingOpportunities' | 'isIndexOwner' | 'isNetworkMember' | 'getUser' | 'getNetwork' | 'getNetworkMemberships' | 'getProfile' | 'getActiveIntents' | 'upsertContactMembership' | 'getOrCreateDM' | 'unhideConversation' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction'>;
-/**
- * Database interface narrowed for Intent Graph operations.
- * Provides state population (getActiveIntents), action execution (create/update/archive),
- * and read operations (query intents; getIntentsInIndexForMember for network-scoped reads).
- *
- * Access layer: UserDatabase (mutations on own intents) + SystemDatabase (network-scoped reads)
- */
-export type IntentGraphDatabase = Pick<Database, 'getActiveIntents' | 'getActiveIntentsAcrossIndexes' | 'getIntentsInIndexForMember' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'isNetworkMember' | 'getNetworkIntentsForMember' | 'getUser' | 'getProfile' | 'getUserContext' | 'getPersonalIndexesForContact' | 'assignIntentToNetwork'>;
-/**
- * Database interface narrowed for Network Graph CRUD operations.
- * Handles create, read, update, delete of indexes (communities).
- *
- * Access layer: UserDatabase (CRUD on own networks and memberships)
- */
-export type NetworkGraphDatabase = Pick<Database, 'getNetworkMemberships' | 'getOwnedIndexes' | 'getPublicIndexesNotJoined' | 'isIndexOwner' | 'isNetworkMember' | 'getNetwork' | 'createNetwork' | 'addMemberToNetwork' | 'updateIndexSettings' | 'softDeleteNetwork' | 'getNetworkMemberCount'>;
-/**
- * Database interface narrowed for Intent Index Graph operations.
- * Provides intent/index context and assignment for intent–index evaluation.
- * (Migrated from the old NetworkGraphDatabase.)
- *
- * Access layer: UserDatabase (own intent assignment) + SystemDatabase (index context)
- */
-export type IntentNetworkGraphDatabase = Pick<Database, 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getNetwork' | 'isIntentAssignedToIndex' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromIndex' | 'getIntent' | 'isNetworkMember' | 'isIndexOwner' | 'getNetworkIdsForIntent' | 'getNetworkIntentsForMember' | 'getIntentsInIndexForMember'>;
-/**
- * Database interface narrowed for Network Membership Graph operations.
- * Handles CRUD for network memberships (add, list, remove members).
- *
- * Access layer: SystemDatabase (cross-user membership operations)
- */
-export type NetworkMembershipGraphDatabase = Pick<Database, 'isNetworkMember' | 'isIndexOwner' | 'getNetworkWithPermissions' | 'addMemberToNetwork' | 'removeMemberFromIndex' | 'getNetworkMembersForMember'>;
-/**
- * Database interface narrowed for HyDE Graph operations.
- * Provides HyDE document CRUD and intent lookup for refresh.
- *
- * Access layer: UserDatabase (own HyDE) + SystemDatabase (cross-user matching)
- */
-export type HydeGraphDatabase = Pick<Database, 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent'>;
-/**
- * Database interface for Radar Graph (opportunity radar view).
- * Load opportunities, enrich with profile/index, and support presenter context.
- *
- * Access layer: UserDatabase (own opportunities and profile)
- */
-export type RadarGraphDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & Pick<NegotiationGraphDatabase, 'getNegotiationTaskForOpportunity' | 'getNegotiationMessages' | 'getArtifactsForTask'>;

package/dist/shared/interfaces/database.interface.d.ts

@@ -1,16 +0,0 @@
-/**
- * The database port, re-exported as one surface.
- *
- * The declarations moved into sibling modules — entities, the four query
- * groups that compose `Database`, the access-scoped views, negotiation
- * persistence, and the capability-narrowed aliases. Importers keep using this
- * path; nothing about the types changed.
- */
-export type * from './database.entities.js';
-export type * from './database.identity-queries.js';
-export type * from './database.network-queries.js';
-export type * from './database.opportunity-queries.js';
-export type * from './database.member-queries.js';
-export type * from './database.port.js';
-export type * from './database.negotiation.js';
-export type * from './database.capabilities.js';

package/dist/shared/interfaces/database.member-queries.d.ts

@@ -1,219 +0,0 @@
-/**
- * Database operations for contacts, premises, and user contexts.
- */
-import type { NetworkAssignmentMetadata } from '../schemas/network-assignment.schema.js';
-import type { PremiseAnalysis, PremiseAssertion, PremiseProvenance, PremiseRecord, PremiseValidity } from './database.entities.js';
-/** Contact, premise and user-context operations. */
-export interface DatabaseMemberQueries {
-    /** Upsert a contact membership in the owner's personal network (network_members with permissions=['contact']). */
-    upsertContactMembership(ownerId: string, contactUserId: string, options?: {
-        restore?: boolean;
-    }): Promise<void>;
-    /**
-     * Finds an existing DM conversation between two users, or creates one.
-     * Uses a unique `dmPair` column (sorted user IDs joined by ':') to
-     * prevent duplicate DMs under concurrency. Used by the Start Chat flow
-     * (Plan B Task 8) to atomically surface the h2h conversation when
-     * accepting an opportunity.
-     */
-    getOrCreateDM(userA: string, userB: string, participantType?: 'user' | 'agent'): Promise<{
-        id: string;
-    }>;
-    /**
-     * Clears hiddenAt for a user on a conversation, making it visible in their
-     * conversation list again. Called by startChat when reusing an existing DM
-     * that the user had previously hidden.
-     */
-    unhideConversation(userId: string, conversationId: string): Promise<void>;
-    /** Hard-delete a contact membership from the owner's personal network. */
-    hardDeleteContactMembership(ownerId: string, contactUserId: string): Promise<void>;
-    /** Get all contact members from the owner's personal network with user details. */
-    getContactMembers(ownerId: string): Promise<Array<{
-        userId: string;
-        user: {
-            id: string;
-            name: string;
-            email: string;
-            avatar: string | null;
-        };
-    }>>;
-    /** Clear a reverse opt-out (reactivate soft-deleted contact membership in another user's personal network). */
-    clearReverseOptOut(ownerId: string, otherUserId: string): Promise<void>;
-    /**
-     * Returns the IDs of personal networks where the given user is a contact member.
-     * Used for auto-assigning new intents to personal networks of contacts who imported this user.
-     *
-     * @param userId - The user whose contact memberships to look up
-     * @returns Array of personal network IDs
-     */
-    getPersonalIndexesForContact(userId: string): Promise<{
-        networkId: string;
-    }[]>;
-    /** Find a user by email. */
-    getUserByEmail(email: string): Promise<{
-        id: string;
-        name: string;
-        email: string;
-    } | null>;
-    createPremise(input: {
-        userId: string;
-        assertion: PremiseAssertion;
-        provenance: PremiseProvenance;
-        analysis?: PremiseAnalysis;
-        validity: PremiseValidity;
-        embedding?: number[];
-    }): Promise<PremiseRecord>;
-    getPremise(premiseId: string): Promise<PremiseRecord | null>;
-    getPremisesForUser(userId: string, status?: 'ACTIVE' | 'RETRACTED' | 'EXPIRED'): Promise<PremiseRecord[]>;
-    /**
-     * Retrieve a user's premises assigned to one of the provided networks.
-     * Optional for older/test adapters; OpportunityGraph falls back to capped
-     * getPremisesForUser results when unavailable.
-     */
-    getPremisesForUserInNetworks?(userId: string, networkIds: string[], status?: 'ACTIVE' | 'RETRACTED' | 'EXPIRED', limit?: number): Promise<PremiseRecord[]>;
-    updatePremise(premiseId: string, updates: {
-        assertion?: PremiseAssertion;
-        analysis?: PremiseAnalysis;
-        validity?: PremiseValidity;
-        embedding?: number[];
-        status?: 'ACTIVE' | 'RETRACTED' | 'EXPIRED';
-        retractedAt?: Date;
-    }): Promise<PremiseRecord>;
-    assignPremiseToNetwork(premiseId: string, networkId: string, relevancyScore: number, assignmentMetadata?: NetworkAssignmentMetadata): Promise<void>;
-    getPremiseNetworks(premiseId: string): Promise<Array<{
-        networkId: string;
-        relevancyScore: number | null;
-        assignmentMetadata?: NetworkAssignmentMetadata | null;
-    }>>;
-    /**
-     * Cosine similarity search against premise embeddings, scoped to shared networks.
-     * Used by the opportunity graph's premise discovery path (path D).
-     */
-    searchPremisesBySimilarity(params: {
-        embedding: number[];
-        networkIds: string[];
-        excludeUserId: string;
-        limit: number;
-        minScore?: number;
-    }): Promise<Array<{
-        premiseId: string;
-        userId: string;
-        networkId: string;
-        assertionText: string;
-        similarity: number;
-    }>>;
-    /**
-     * Cosine similarity search against user_context embeddings, scoped to shared networks.
-     * Matches only per-network context rows (the global networkId-null row is never a
-     * candidate), excluding the discovering user. Optional — lightweight-mode
-     * context-to-context discovery no-ops when the adapter omits it.
-     */
-    searchUserContextsBySimilarity?(params: {
-        embedding: number[];
-        networkIds: string[];
-        excludeUserId: string;
-        limit: number;
-        minScore?: number;
-    }): Promise<Array<{
-        contextId: string;
-        userId: string;
-        networkId: string;
-        text: string;
-        similarity: number;
-    }>>;
-    /**
-     * Batched version of premise similarity search. Executes one bounded DB call
-     * for all selected source premises instead of one query per source premise.
-     * Optional for older/test adapters; OpportunityGraph falls back to the
-     * single-source method when unavailable.
-     */
-    searchPremisesBySimilarityBatch?(params: {
-        sources: Array<{
-            premiseId: string;
-            embedding: number[];
-        }>;
-        networkIds: string[];
-        excludeUserId: string;
-        limitPerSource: number;
-        minScore?: number;
-    }): Promise<Array<{
-        sourcePremiseId: string;
-        premiseId: string;
-        userId: string;
-        networkId: string;
-        assertionText: string;
-        similarity: number;
-    }>>;
-    /**
-     * Find the single most-similar ACTIVE premise belonging to the SAME user whose
-     * cosine similarity to `embedding` meets or exceeds `threshold`. Used by the
-     * premise graph to skip near-duplicate premises on create. Returns null when no
-     * active premise clears the threshold (or the user has none with an embedding).
-     * Optional so older/test adapters can omit it — the premise graph skips dedup
-     * when it is unavailable.
-     */
-    findSimilarActivePremise?(params: {
-        userId: string;
-        embedding: number[];
-        threshold: number;
-    }): Promise<{
-        premiseId: string;
-        assertionText: string;
-        similarity: number;
-    } | null>;
-    /**
-     * Upsert a user context. Pass a concrete `networkId` for a per-network row, or
-     * `null` for the user's single global (profile-replacing) context row.
-     * Creates or updates the synthesized context paragraph + embedding.
-     */
-    upsertUserContext(params: {
-        userId: string;
-        networkId: string | null;
-        text: string;
-        embedding: number[];
-        premiseHash: string;
-    }): Promise<{
-        id: string;
-    }>;
-    /**
-     * Get the user context for a specific user+network pair, or the global row when
-     * `networkId` is `null`.
-     */
-    getUserContext(userId: string, networkId: string | null): Promise<{
-        id: string;
-        text: string;
-        embedding: number[];
-        premiseHash: string;
-        generatedAt: Date;
-    } | null>;
-    /**
-     * Get user contexts for a user across all their networks. Includes the global
-     * row (`networkId: null`) when present.
-     */
-    getUserContexts(userId: string): Promise<Array<{
-        id: string;
-        networkId: string | null;
-        text: string;
-        embedding: number[];
-        premiseHash: string;
-        generatedAt: Date;
-    }>>;
-    /**
-     * Cosine similarity search against intent embeddings using a context embedding.
-     * Restores the profile→intent cross-search deleted when Path B was removed.
-     */
-    searchIntentsByContextEmbedding(params: {
-        embedding: number[];
-        networkIds: string[];
-        excludeUserId: string;
-        limit: number;
-        minScore?: number;
-    }): Promise<Array<{
-        intentId: string;
-        userId: string;
-        networkId: string;
-        payload: string;
-        summary: string | null;
-        similarity: number;
-    }>>;
-}

package/dist/shared/interfaces/database.member-queries.js

@@ -1,4 +0,0 @@
-/**
- * Database operations for contacts, premises, and user contexts.
- */
-export {};