@indexnetwork/protocol 6.15.0-rc.407.1 → 8.0.1-rc.417.1

package/dist/opportunity/application/opportunity.discovery-continuation-finalization.d.ts

@@ -1,34 +0,0 @@
-import type { Cache } from '../../shared/interfaces/cache.interface.js';
-import type { ChatGraphCompositeDatabase, Opportunity } from '../../shared/interfaces/database.interface.js';
-import type { CandidateMatch } from '../domain/opportunity.state.js';
-import type { DiscoverDebugStep, DiscoveryResultContract } from '../domain/opportunity.discovery.contracts.js';
-export interface DiscoveryContinuationCacheSession {
-    candidates: CandidateMatch[];
-}
-export interface DiscoveryContinuationGraphResult {
-    trace?: Array<{
-        node: string;
-        detail?: string;
-        data?: Record<string, unknown>;
-    }>;
-    error?: string;
-    remainingCandidates?: CandidateMatch[];
-    opportunities?: Opportunity[];
-}
-interface DiscoveryContinuationFinalizationInput<TOpportunity> {
-    result: DiscoveryContinuationGraphResult;
-    cache: Pick<Cache, 'set' | 'delete'>;
-    cacheKey: string;
-    cached: DiscoveryContinuationCacheSession;
-    userId: string;
-    discoveryId: string;
-    database: Pick<ChatGraphCompositeDatabase, 'getOpportunitiesByIds'>;
-    enrich: (opportunities: Opportunity[], debugSteps: DiscoverDebugStep[]) => Promise<TOpportunity[]>;
-}
-/**
- * Finalizes a successful continuation graph result without owning session
- * lookup, scope admission, or graph invocation. Cache failures are advisory;
- * lifecycle refresh and presentation use the graph result regardless.
- */
-export declare function finalizeDiscoveryContinuation<TOpportunity>(args: DiscoveryContinuationFinalizationInput<TOpportunity>): Promise<DiscoveryResultContract<TOpportunity>>;
-export {};

package/dist/opportunity/application/opportunity.discovery-continuation-finalization.js

@@ -1,74 +0,0 @@
-import { protocolLogger } from '../../shared/observability/protocol.logger.js';
-const logger = protocolLogger('OpportunityDiscover');
-/**
- * Finalizes a successful continuation graph result without owning session
- * lookup, scope admission, or graph invocation. Cache failures are advisory;
- * lifecycle refresh and presentation use the graph result regardless.
- */
-export async function finalizeDiscoveryContinuation(args) {
-    const debugSteps = [];
-    for (const trace of args.result.trace || []) {
-        debugSteps.push({
-            step: trace.node,
-            detail: trace.detail,
-            ...(trace.data ? { data: trace.data } : {}),
-        });
-    }
-    if (args.result.error) {
-        logger.warn('continueDiscovery graph returned error', { error: args.result.error });
-        return {
-            found: false,
-            count: 0,
-            message: 'Discovery continuation failed. Please start a new search.',
-            debugSteps,
-        };
-    }
-    const remaining = args.result.remainingCandidates || [];
-    let pagination;
-    try {
-        if (remaining.length > 0) {
-            await args.cache.set(args.cacheKey, {
-                ...args.cached,
-                candidates: remaining,
-            }, { ttl: 1800 });
-            pagination = {
-                discoveryId: args.discoveryId,
-                evaluated: args.cached.candidates.length - remaining.length,
-                remaining: remaining.length,
-            };
-        }
-        else {
-            await args.cache.delete(args.cacheKey);
-        }
-    }
-    catch (cacheErr) {
-        logger.warn('Failed to update discovery pagination cache', {
-            userId: args.userId,
-            discoveryId: args.discoveryId,
-            error: cacheErr instanceof Error ? cacheErr.message : String(cacheErr),
-        });
-    }
-    const opportunities = Array.isArray(args.result.opportunities) ? args.result.opportunities : [];
-    const refreshed = opportunities.length > 0
-        ? await args.database.getOpportunitiesByIds(opportunities.map((opportunity) => opportunity.id))
-        : [];
-    const refreshedById = new Map(refreshed.map((opportunity) => [opportunity.id, opportunity]));
-    const currentOpportunities = opportunities.map((opportunity) => refreshedById.get(opportunity.id) ?? opportunity);
-    if (currentOpportunities.length === 0) {
-        return {
-            found: false,
-            count: 0,
-            message: 'No more matching opportunities found in the remaining candidates.',
-            debugSteps,
-            pagination,
-        };
-    }
-    const enriched = await args.enrich(currentOpportunities, debugSteps);
-    return {
-        found: true,
-        count: enriched.length,
-        opportunities: enriched,
-        debugSteps,
-        pagination,
-    };
-}

package/dist/opportunity/application/opportunity.discovery-mcp-lifecycle-finalization.d.ts

@@ -1,44 +0,0 @@
-import type { OpportunityStatus } from '../../shared/interfaces/database.interface.js';
-import type { OpportunityCardLike } from './opportunity.card-presentation.js';
-import type { ExistingConnection, FormattedDiscoveryCandidate } from './opportunity.discover.js';
-type DiscoveryPagination = {
-    discoveryId: string;
-    evaluated: number;
-    remaining: number;
-};
-export interface DiscoveryMcpLifecycleFinalizationInput<TCard extends OpportunityCardLike> {
-    isMcp: boolean;
-    candidates: FormattedDiscoveryCandidate[];
-    existingConnections?: ExistingConnection[];
-    existingConnectionsForMention?: ExistingConnection[];
-    alreadyAcceptedPairs?: Array<{
-        opportunityId: string;
-        counterpartyUserId: string;
-    }>;
-    pagination?: DiscoveryPagination;
-    isIntroducerFlow: boolean;
-    displayLimit: number;
-    readOpportunitiesByIds: (ids: string[]) => Promise<Array<{
-        id: string;
-        status: OpportunityStatus;
-    }>>;
-    warn: (message: string, data: Record<string, unknown>) => void;
-    /** The caller supplies the only allowed safe-presentation path for card text. */
-    projectSafeCard: (candidate: FormattedDiscoveryCandidate) => TCard;
-}
-export interface DiscoveryMcpLifecycleFinalization<TCard extends OpportunityCardLike> {
-    displayedCards: TCard[];
-    /** Source candidates retain viewer approval data for facade-owned link minting. */
-    displayedCandidates: FormattedDiscoveryCandidate[];
-    negotiatingCount: number;
-    /** Adds lifecycle-aware completion copy after facade-owned link decoration. */
-    composeMessage: (baseMessage: string) => string;
-}
-/**
- * Reconciles a discovery graph result with authoritative opportunity lifecycle
- * rows before the MCP tool presents cards. Graph output is intentionally not
- * trusted for new-card lifecycle after its negotiate phase. The tools facade
- * continues to own link writes and the outer tool response.
- */
-export declare function finalizeMcpDiscoveryLifecycle<TCard extends OpportunityCardLike>(input: DiscoveryMcpLifecycleFinalizationInput<TCard>): Promise<DiscoveryMcpLifecycleFinalization<TCard>>;
-export {};

package/dist/opportunity/application/opportunity.discovery-mcp-lifecycle-finalization.js

@@ -1,92 +0,0 @@
-function existingConnectionsNarrative(connections) {
-    if (connections.length === 0)
-        return '';
-    return ('\n\nYou already have a connection with: ' +
-        connections.map((connection) => connection.name + (connection.status ? ` (${connection.status})` : '')).join(', ') +
-        '. View on your home page.');
-}
-function alreadyAcceptedNarrative(alreadyAcceptedPairs) {
-    if (alreadyAcceptedPairs.length === 0)
-        return '';
-    return `\n\nYou already have ${alreadyAcceptedPairs.length} accepted opportunity(ies) with some of these candidates — open the existing chat with them rather than creating a new draft.`;
-}
-/**
- * Reconciles a discovery graph result with authoritative opportunity lifecycle
- * rows before the MCP tool presents cards. Graph output is intentionally not
- * trusted for new-card lifecycle after its negotiate phase. The tools facade
- * continues to own link writes and the outer tool response.
- */
-export async function finalizeMcpDiscoveryLifecycle(input) {
-    const existingConnectionIds = new Set((input.existingConnections ?? [])
-        .map((connection) => connection.opportunityId)
-        .filter((id) => typeof id === 'string'));
-    let negotiatingCount = 0;
-    let visibleCandidates = input.candidates;
-    if (input.isMcp && input.candidates.length > 0) {
-        const newCardIds = input.candidates
-            .filter((candidate) => !existingConnectionIds.has(candidate.opportunityId))
-            .map((candidate) => candidate.opportunityId);
-        const refreshed = newCardIds.length > 0
-            ? await input.readOpportunitiesByIds(newCardIds)
-            : [];
-        const statusById = new Map(refreshed.map((opportunity) => [opportunity.id, opportunity.status]));
-        const draftCandidates = [];
-        for (const candidate of input.candidates) {
-            if (existingConnectionIds.has(candidate.opportunityId)) {
-                // Re-surfaced connections preserve their discover-time lifecycle.
-                draftCandidates.push(candidate);
-                continue;
-            }
-            const refreshedStatus = statusById.get(candidate.opportunityId);
-            if (refreshedStatus === 'draft') {
-                draftCandidates.push({ ...candidate, status: refreshedStatus });
-                continue;
-            }
-            if (refreshedStatus === 'negotiating') {
-                negotiatingCount += 1;
-                continue;
-            }
-            if (refreshedStatus === 'rejected' || refreshedStatus === 'stalled') {
-                continue;
-            }
-            // Pending, latent, and missing rows are not expected after the graph's
-            // negotiate phase. Preserve the established fail-closed display policy:
-            // do not surface a card, but make the deferred state observable.
-            input.warn('unexpected refreshed status — counting as negotiating', {
-                opportunityId: candidate.opportunityId,
-                refreshedStatus,
-            });
-            negotiatingCount += 1;
-        }
-        visibleCandidates = draftCandidates;
-    }
-    // Projection is supplied by the tools facade so this policy cannot choose a
-    // raw-reasoning path; callers must use getSafePresentationOrSkip-compatible copy.
-    const projectedCards = visibleCandidates.map(input.projectSafeCard);
-    const displayedCards = projectedCards.slice(0, input.displayLimit);
-    const displayedCandidates = visibleCandidates.slice(0, input.displayLimit);
-    const extraFromCap = projectedCards.length - displayedCards.length;
-    const existingNarrative = existingConnectionsNarrative(input.existingConnectionsForMention ?? input.existingConnections ?? []);
-    const acceptedNarrative = alreadyAcceptedNarrative(input.alreadyAcceptedPairs ?? []);
-    const totalRemaining = (input.pagination?.remaining ?? 0) + extraFromCap;
-    const completionNarrative = totalRemaining > 0 && input.pagination?.discoveryId
-        ? `\n\nThere are ${totalRemaining} more candidates. Ask if the user wants to see more — they can say "show me more" and you should call discover_opportunities with continueFrom="${input.pagination.discoveryId}".`
-        : input.isIntroducerFlow
-            ? '\n\nThese are all the introduction candidates I found for this person.'
-            : '\n\nThese are all the connections I found. If the user wants to attract more connections, suggest they create a signal — e.g. "Would you like to create a signal so others looking for someone like you can find you?" If they agree, call create_intent with a description based on what they were searching for.';
-    return {
-        displayedCards,
-        displayedCandidates,
-        negotiatingCount,
-        composeMessage(baseMessage) {
-            const message = baseMessage + existingNarrative + acceptedNarrative + completionNarrative;
-            if (!input.isMcp || negotiatingCount === 0)
-                return message;
-            if (displayedCards.length > 0) {
-                return message + `\n\n${negotiatingCount} more opportunit${negotiatingCount === 1 ? 'y is' : 'ies are'} still being evaluated — check back via \`list_opportunities\` shortly.`;
-            }
-            // Preserve existing/accepted facts but omit card-only completion copy.
-            return `Found candidates, but they're still being evaluated. Try \`list_opportunities\` in a minute — ${negotiatingCount} pending.` + existingNarrative + acceptedNarrative;
-        },
-    };
-}

package/dist/opportunity/domain/opportunity.discovery-run-coalescing.d.ts

@@ -1,33 +0,0 @@
-type DiscoveryRunScope = {
-    scopeType?: string;
-    scopeId?: string;
-};
-type DiscoveryCoalescingRequest = {
-    continueFrom?: string;
-    searchQuery?: string;
-    networkId?: string;
-    intentId?: string;
-    targetUserId?: string;
-    introTargetUserId?: string;
-    partyUserIds?: string[];
-    entities?: Array<{
-        userId: string;
-        networkId: string;
-    }>;
-    hint?: string;
-};
-type ActiveDiscoveryRunForCoalescing = {
-    id: string;
-    status: string;
-    input: DiscoveryCoalescingRequest;
-    context: DiscoveryRunScope;
-};
-/**
- * Finds an active MCP discovery run that describes the same user request and
- * resolved scope boundary. The identity is deliberately normalized so harmless
- * formatting differences share one expensive graph execution, while distinct
- * hints, opaque continuation tokens, entity networks, and scopes remain
- * independent runs.
- */
-export declare function findCoalescedDiscoveryRun(input: DiscoveryCoalescingRequest, context: DiscoveryRunScope, activeRuns: readonly ActiveDiscoveryRunForCoalescing[]): ActiveDiscoveryRunForCoalescing | undefined;
-export {};

package/dist/opportunity/domain/opportunity.discovery-run-coalescing.js

@@ -1,33 +0,0 @@
-/**
- * Finds an active MCP discovery run that describes the same user request and
- * resolved scope boundary. The identity is deliberately normalized so harmless
- * formatting differences share one expensive graph execution, while distinct
- * hints, opaque continuation tokens, entity networks, and scopes remain
- * independent runs.
- */
-export function findCoalescedDiscoveryRun(input, context, activeRuns) {
-    const signature = discoveryRunSignature(input, context);
-    return activeRuns.find((run) => discoveryRunSignature(run.input, run.context) === signature);
-}
-function discoveryRunSignature(input, scope) {
-    const text = (value) => (value ?? "").trim().toLowerCase();
-    const id = (value) => (value ?? "").trim();
-    const entities = [...(input.entities ?? [])]
-        .map((entity) => JSON.stringify([id(entity.networkId), id(entity.userId)]))
-        .sort();
-    return JSON.stringify({
-        searchQuery: text(input.searchQuery),
-        networkId: id(input.networkId),
-        intentId: id(input.intentId),
-        targetUserId: id(input.targetUserId),
-        introTargetUserId: id(input.introTargetUserId),
-        continueFrom: id(input.continueFrom),
-        hint: text(input.hint),
-        partyUserIds: [...(input.partyUserIds ?? [])].map((value) => value.trim()).sort(),
-        entities,
-        scope: {
-            scopeType: id(scope.scopeType),
-            scopeId: id(scope.scopeId),
-        },
-    });
-}

package/dist/opportunity/domain/opportunity.discovery.contracts.d.ts

@@ -1,45 +0,0 @@
-import type { Question, QuestionStrategy } from "../../shared/schemas/question.schema.js";
-/** One step for discovery debug visibility (subgraph/subtask). */
-export interface DiscoverDebugStep {
-    step: string;
-    detail?: string;
-    data?: Record<string, unknown>;
-}
-/** Neutral discovery result envelope shared with continuation finalization. */
-export interface DiscoveryResultContract<TOpportunity> {
-    found: boolean;
-    count: number;
-    message?: string;
-    opportunities?: TOpportunity[];
-    existingConnections?: Array<{
-        userId: string;
-        name: string;
-        status?: string;
-        opportunityId?: string;
-    }>;
-    existingConnectionsForMention?: Array<{
-        userId: string;
-        name: string;
-        status?: string;
-        opportunityId?: string;
-    }>;
-    alreadyAcceptedPairs?: Array<{
-        opportunityId: string;
-        counterpartyUserId: string;
-    }>;
-    createIntentSuggested?: boolean;
-    suggestedIntentDescription?: string;
-    debugSteps?: DiscoverDebugStep[];
-    pagination?: {
-        discoveryId: string;
-        evaluated: number;
-        remaining: number;
-    };
-    questions?: Question[];
-    discoveryQuestionsDebug?: {
-        inputMode: "transcripts" | "insights";
-        finalCount: number;
-        strategies: QuestionStrategy[];
-        durationMs: number;
-    };
-}

package/dist/opportunity/domain/opportunity.discovery.contracts.js

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

package/dist/opportunity/opportunity.discover.d.ts

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/application/opportunity.discover.ts
- */
-export * from "./application/opportunity.discover.js";

package/dist/opportunity/opportunity.discover.js

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/application/opportunity.discover.ts
- */
-export * from "./application/opportunity.discover.js";

package/dist/opportunity/opportunity.discovery-continuation-finalization.d.ts

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/application/opportunity.discovery-continuation-finalization.ts
- */
-export * from "./application/opportunity.discovery-continuation-finalization.js";

package/dist/opportunity/opportunity.discovery-continuation-finalization.js

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/application/opportunity.discovery-continuation-finalization.ts
- */
-export * from "./application/opportunity.discovery-continuation-finalization.js";

package/dist/opportunity/opportunity.discovery-mcp-lifecycle-finalization.d.ts

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/application/opportunity.discovery-mcp-lifecycle-finalization.ts
- */
-export * from "./application/opportunity.discovery-mcp-lifecycle-finalization.js";

package/dist/opportunity/opportunity.discovery-mcp-lifecycle-finalization.js

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/application/opportunity.discovery-mcp-lifecycle-finalization.ts
- */
-export * from "./application/opportunity.discovery-mcp-lifecycle-finalization.js";

package/dist/opportunity/opportunity.discovery-run-coalescing.d.ts

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/domain/opportunity.discovery-run-coalescing.ts
- */
-export * from "./domain/opportunity.discovery-run-coalescing.js";

package/dist/opportunity/opportunity.discovery-run-coalescing.js

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/domain/opportunity.discovery-run-coalescing.ts
- */
-export * from "./domain/opportunity.discovery-run-coalescing.js";

package/dist/opportunity/opportunity.discovery.contracts.d.ts

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/domain/opportunity.discovery.contracts.ts
- */
-export * from "./domain/opportunity.discovery.contracts.js";

package/dist/opportunity/opportunity.discovery.contracts.js

@@ -1,5 +0,0 @@
-/**
- * Thin backward-compat shim — IND-551.
- * Canonical location: opportunity/domain/opportunity.discovery.contracts.ts
- */
-export * from "./domain/opportunity.discovery.contracts.js";

package/dist/shared/interfaces/discovery-run.interface.d.ts

@@ -1,70 +0,0 @@
-import type { ToolRequestContext } from "./tool-request-context.interface.js";
-export type DiscoveryRunStatus = "queued" | "running" | "succeeded" | "failed" | "cancelled";
-export interface DiscoveryRunInput {
-    continueFrom?: string;
-    searchQuery?: string;
-    networkId?: string;
-    intentId?: string;
-    targetUserId?: string;
-    introTargetUserId?: string;
-    partyUserIds?: string[];
-    entities?: Array<{
-        userId: string;
-        profile?: {
-            name?: string;
-            bio?: string;
-            location?: string;
-            interests?: string[];
-            skills?: string[];
-            context?: string;
-        };
-        intents?: Array<{
-            intentId: string;
-            payload: string;
-            summary?: string;
-        }>;
-        networkId: string;
-    }>;
-    hint?: string;
-}
-export interface DiscoveryRunRecord {
-    id: string;
-    userId: string;
-    agentId?: string | null;
-    status: DiscoveryRunStatus;
-    input: DiscoveryRunInput;
-    context: Pick<ToolRequestContext, "userId" | "userName" | "userEmail" | "scopeType" | "scopeId" | "indexName" | "sessionId" | "agentId" | "clientSurface">;
-    progress?: Record<string, unknown> | null;
-    result?: unknown;
-    error?: string | null;
-    cancelRequestedAt?: Date | null;
-    createdAt: Date;
-    startedAt?: Date | null;
-    completedAt?: Date | null;
-    expiresAt?: Date | null;
-}
-export interface CreateDiscoveryRunInput {
-    userId: string;
-    agentId?: string | null;
-    input: DiscoveryRunInput;
-    context: DiscoveryRunRecord["context"];
-    expiresAt?: Date;
-}
-export interface DiscoveryRunStore {
-    create(input: CreateDiscoveryRunInput): Promise<DiscoveryRunRecord>;
-    get(runId: string, userId: string): Promise<DiscoveryRunRecord | null>;
-    markRunning(runId: string): Promise<DiscoveryRunRecord | null>;
-    updateProgress(runId: string, progress: Record<string, unknown>): Promise<void>;
-    markSucceeded(runId: string, result: unknown): Promise<void>;
-    markFailed(runId: string, error: string): Promise<void>;
-    requestCancel(runId: string, userId: string): Promise<DiscoveryRunRecord | null>;
-    markCancelled(runId: string, reason?: string): Promise<void>;
-    isCancelRequested(runId: string): Promise<boolean>;
-    listActive(userId: string, limit?: number): Promise<DiscoveryRunRecord[]>;
-}
-export interface DiscoveryRunQueue {
-    enqueue(runId: string): Promise<{
-        jobId?: string | number;
-    } | void>;
-    cancel(runId: string): Promise<boolean>;
-}

package/dist/shared/interfaces/discovery-run.interface.js

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