@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0

package/dist/maintenance/maintenance.graph.d.ts

@@ -1,239 +0,0 @@
-import { MaintenanceGraphState } from './maintenance.state.js';
-/** Database methods needed by the maintenance graph (includes introducer discovery). */
-export interface MaintenanceGraphDatabase {
-    getOpportunitiesForUser(userId: string, options?: {
-        limit?: number;
-    }): Promise<Array<{
-        id: string;
-        actors: Array<{
-            userId: string;
-            role: string;
-        }>;
-        status: string;
-        [key: string]: unknown;
-    }>>;
-    getActiveIntents(userId: string): Promise<Array<{
-        id: string;
-        payload: string;
-    }>>;
-    /** Get the user's personal network ID (for introducer discovery). */
-    getPersonalIndexId(userId: string): Promise<string | null>;
-    /** Get contacts with intent freshness data from a personal network (for introducer discovery). */
-    getContactsWithIntentFreshness(personalIndexId: string, ownerId: string, limit: number): Promise<Array<{
-        userId: string;
-        latestIntentAt: string | null;
-        intentCount: number;
-    }>>;
-}
-/** Cache methods needed by the maintenance graph. */
-export interface MaintenanceGraphCache {
-    get<T = unknown>(key: string): Promise<T | null>;
-    set(key: string, value: unknown, options?: {
-        ttl?: number;
-    }): Promise<void>;
-}
-/** Queue methods needed by the maintenance graph. */
-export interface MaintenanceGraphQueue {
-    addJob(data: {
-        intentId: string;
-        userId: string;
-        indexIds?: string[];
-        contactUserId?: string;
-    }, options?: {
-        priority?: number;
-        jobId?: string;
-    }): Promise<unknown>;
-}
-/**
- * Factory for the Maintenance Graph.
- * Accepts database, cache, and queue dependencies via constructor injection.
- */
-/** The graph's channel state, as every node sees it. */
-export type MaintenanceState = typeof MaintenanceGraphState.State;
-/** Everything the maintenance nodes reach for. */
-export interface MaintenanceGraphDeps {
-    database: MaintenanceGraphDatabase;
-    cache: MaintenanceGraphCache;
-    queue: MaintenanceGraphQueue;
-}
-/**
- * Factory for the Maintenance Graph.
- * Accepts database, cache, and queue dependencies via constructor injection.
- */
-export declare class MaintenanceGraphFactory {
-    /** Resolved dependency bag shared by every node. */
-    readonly deps: MaintenanceGraphDeps;
-    constructor(database: MaintenanceGraphDatabase, cache: MaintenanceGraphCache, queue: MaintenanceGraphQueue);
-    /** Compile and return the maintenance graph. */
-    createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
-        userId: string;
-        activeIntents: {
-            id: string;
-            payload: string;
-        }[];
-        currentOpportunities: import("../index.js").Opportunity[];
-        expiredCount: number;
-        lastRediscoveryAt: number | null;
-        healthResult: import("../opportunities/radar/radar.health.js").RadarHealthResult | null;
-        rediscoveryJobsEnqueued: number;
-        connectorFlowCount: number;
-        introducerDiscoveryJobsEnqueued: number;
-        error: string | undefined;
-    }, {
-        userId?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
-        activeIntents?: {
-            id: string;
-            payload: string;
-        }[] | import("@langchain/langgraph").OverwriteValue<{
-            id: string;
-            payload: string;
-        }[]> | undefined;
-        currentOpportunities?: import("../index.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../index.js").Opportunity[]> | undefined;
-        expiredCount?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
-        lastRediscoveryAt?: number | import("@langchain/langgraph").OverwriteValue<number | null> | null | undefined;
-        healthResult?: import("../opportunities/radar/radar.health.js").RadarHealthResult | import("@langchain/langgraph").OverwriteValue<import("../opportunities/radar/radar.health.js").RadarHealthResult | null> | null | undefined;
-        rediscoveryJobsEnqueued?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
-        connectorFlowCount?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
-        introducerDiscoveryJobsEnqueued?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
-        error?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
-    }, "__start__" | "loadCurrentRadar" | "scoreRadarHealth" | "rediscover" | "introducerDiscovery" | "logMaintenance", {
-        userId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
-        activeIntents: import("@langchain/langgraph").BaseChannel<{
-            id: string;
-            payload: string;
-        }[], {
-            id: string;
-            payload: string;
-        }[] | import("@langchain/langgraph").OverwriteValue<{
-            id: string;
-            payload: string;
-        }[]>, unknown>;
-        currentOpportunities: import("@langchain/langgraph").BaseChannel<import("../index.js").Opportunity[], import("../index.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../index.js").Opportunity[]>, unknown>;
-        expiredCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        lastRediscoveryAt: import("@langchain/langgraph").BaseChannel<number | null, number | import("@langchain/langgraph").OverwriteValue<number | null> | null, unknown>;
-        healthResult: import("@langchain/langgraph").BaseChannel<import("../opportunities/radar/radar.health.js").RadarHealthResult | null, import("../opportunities/radar/radar.health.js").RadarHealthResult | import("@langchain/langgraph").OverwriteValue<import("../opportunities/radar/radar.health.js").RadarHealthResult | null> | null, unknown>;
-        rediscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        connectorFlowCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        introducerDiscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-    }, {
-        userId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
-        activeIntents: import("@langchain/langgraph").BaseChannel<{
-            id: string;
-            payload: string;
-        }[], {
-            id: string;
-            payload: string;
-        }[] | import("@langchain/langgraph").OverwriteValue<{
-            id: string;
-            payload: string;
-        }[]>, unknown>;
-        currentOpportunities: import("@langchain/langgraph").BaseChannel<import("../index.js").Opportunity[], import("../index.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../index.js").Opportunity[]>, unknown>;
-        expiredCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        lastRediscoveryAt: import("@langchain/langgraph").BaseChannel<number | null, number | import("@langchain/langgraph").OverwriteValue<number | null> | null, unknown>;
-        healthResult: import("@langchain/langgraph").BaseChannel<import("../opportunities/radar/radar.health.js").RadarHealthResult | null, import("../opportunities/radar/radar.health.js").RadarHealthResult | import("@langchain/langgraph").OverwriteValue<import("../opportunities/radar/radar.health.js").RadarHealthResult | null> | null, unknown>;
-        rediscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        connectorFlowCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        introducerDiscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-    }, import("@langchain/langgraph").StateDefinition, {
-        loadCurrentRadar: import("@langchain/langgraph").UpdateType<{
-            userId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
-            activeIntents: import("@langchain/langgraph").BaseChannel<{
-                id: string;
-                payload: string;
-            }[], {
-                id: string;
-                payload: string;
-            }[] | import("@langchain/langgraph").OverwriteValue<{
-                id: string;
-                payload: string;
-            }[]>, unknown>;
-            currentOpportunities: import("@langchain/langgraph").BaseChannel<import("../index.js").Opportunity[], import("../index.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../index.js").Opportunity[]>, unknown>;
-            expiredCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-            lastRediscoveryAt: import("@langchain/langgraph").BaseChannel<number | null, number | import("@langchain/langgraph").OverwriteValue<number | null> | null, unknown>;
-            healthResult: import("@langchain/langgraph").BaseChannel<import("../opportunities/radar/radar.health.js").RadarHealthResult | null, import("../opportunities/radar/radar.health.js").RadarHealthResult | import("@langchain/langgraph").OverwriteValue<import("../opportunities/radar/radar.health.js").RadarHealthResult | null> | null, unknown>;
-            rediscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-            connectorFlowCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-            introducerDiscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-            error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        }>;
-        scoreRadarHealth: {
-            healthResult?: undefined;
-            connectorFlowCount?: undefined;
-            error?: undefined;
-        } | {
-            healthResult: import("../opportunities/radar/radar.health.js").RadarHealthResult;
-            connectorFlowCount: number;
-            error?: undefined;
-        } | {
-            error: string;
-            healthResult?: undefined;
-            connectorFlowCount?: undefined;
-        };
-        rediscover: {
-            rediscoveryJobsEnqueued: number;
-            error?: undefined;
-        } | {
-            error: string;
-            rediscoveryJobsEnqueued?: undefined;
-        };
-        introducerDiscovery: {
-            introducerDiscoveryJobsEnqueued?: undefined;
-        } | {
-            introducerDiscoveryJobsEnqueued: number;
-        };
-        logMaintenance: {};
-    }, unknown, unknown, []>;
-}
-export declare function loadCurrentRadarNode(state: MaintenanceState, deps: MaintenanceGraphDeps): Promise<{
-    error: string;
-    currentOpportunities?: undefined;
-    expiredCount?: undefined;
-    activeIntents?: undefined;
-    lastRediscoveryAt?: undefined;
-} | {
-    currentOpportunities: {
-        [key: string]: unknown;
-        id: string;
-        actors: Array<{
-            userId: string;
-            role: string;
-        }>;
-        status: string;
-    }[];
-    expiredCount: number;
-    activeIntents: {
-        id: string;
-        payload: string;
-    }[];
-    lastRediscoveryAt: number | null;
-    error?: undefined;
-}>;
-export declare function scoreRadarHealthNode(state: MaintenanceState): Promise<{
-    healthResult?: undefined;
-    connectorFlowCount?: undefined;
-    error?: undefined;
-} | {
-    healthResult: import("../opportunities/radar/radar.health.js").RadarHealthResult;
-    connectorFlowCount: number;
-    error?: undefined;
-} | {
-    error: string;
-    healthResult?: undefined;
-    connectorFlowCount?: undefined;
-}>;
-export declare function shouldRediscover(state: MaintenanceState): string;
-export declare function rediscoverNode(state: MaintenanceState, deps: MaintenanceGraphDeps): Promise<{
-    rediscoveryJobsEnqueued: number;
-    error?: undefined;
-} | {
-    error: string;
-    rediscoveryJobsEnqueued?: undefined;
-}>;
-export declare function introducerDiscoveryNode(state: MaintenanceState, deps: MaintenanceGraphDeps): Promise<{
-    introducerDiscoveryJobsEnqueued?: undefined;
-} | {
-    introducerDiscoveryJobsEnqueued: number;
-}>;
-export declare function logMaintenanceNode(state: MaintenanceState): Promise<{}>;

package/dist/maintenance/maintenance.graph.js

@@ -1,199 +0,0 @@
-/**
- * Maintenance Graph: evaluate radar health and trigger rediscovery when unhealthy.
- * Also runs introducer discovery when connector-flow slots are underfilled.
- *
- * Write path — separate from the read-only RadarGraph.
- * Flow: loadCurrentRadar → scoreRadarHealth → [shouldRediscover] → rediscover → introducerDiscovery → logMaintenance → END
- *                                          └─ [skip rediscovery] ─────────────→ introducerDiscovery → logMaintenance → END
- */
-import { StateGraph, START, END } from '@langchain/langgraph';
-import { MaintenanceGraphState } from './maintenance.state.js';
-import { computeRadarHealth } from '../opportunities/radar/radar.health.js';
-import { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS } from '../opportunities/opportunity.utils.js';
-import { shouldRunIntroducerDiscovery, runIntroducerDiscovery } from '../opportunities/opportunity.introducer.js';
-import { isIntroducerDiscoveryEnabled } from '../opportunities/opportunity.introducer-feature.js';
-import { protocolLogger } from '../shared/observability/protocol.logger.js';
-const logger = protocolLogger('MaintenanceGraph');
-const FRESHNESS_WINDOW_MS = 12 * 60 * 60 * 1000; // 12 hours
-/**
- * Factory for the Maintenance Graph.
- * Accepts database, cache, and queue dependencies via constructor injection.
- */
-export class MaintenanceGraphFactory {
-    constructor(database, cache, queue) {
-        this.deps = { database, cache, queue };
-    }
-    /** Compile and return the maintenance graph. */
-    createGraph() {
-        const deps = this.deps;
-        const graph = new StateGraph(MaintenanceGraphState)
-            .addNode('loadCurrentRadar', (state) => loadCurrentRadarNode(state, deps))
-            .addNode('scoreRadarHealth', scoreRadarHealthNode)
-            .addNode('rediscover', (state) => rediscoverNode(state, deps))
-            .addNode('introducerDiscovery', (state) => introducerDiscoveryNode(state, deps))
-            .addNode('logMaintenance', logMaintenanceNode)
-            .addEdge(START, 'loadCurrentRadar')
-            .addConditionalEdges('loadCurrentRadar', (state) => (state.error ? 'end' : 'scoreRadarHealth'), {
-            scoreRadarHealth: 'scoreRadarHealth',
-            end: END,
-        })
-            .addConditionalEdges('scoreRadarHealth', shouldRediscover, {
-            rediscover: 'rediscover',
-            introducerDiscovery: 'introducerDiscovery',
-        })
-            .addEdge('rediscover', 'introducerDiscovery')
-            .addEdge('introducerDiscovery', 'logMaintenance')
-            .addEdge('logMaintenance', END);
-        return graph.compile();
-    }
-}
-export async function loadCurrentRadarNode(state, deps) {
-    if (!state.userId) {
-        return { error: 'userId is required' };
-    }
-    try {
-        const raw = await deps.database.getOpportunitiesForUser(state.userId, { limit: 150 });
-        const actionable = raw.filter((opp) => isActionableForViewer(opp.actors, opp.status, state.userId));
-        const expired = raw.filter((opp) => opp.status === 'expired' && canUserSeeOpportunity(opp.actors, opp.status, state.userId));
-        const activeIntents = await deps.database.getActiveIntents(state.userId);
-        // Read last rediscovery timestamp from cache
-        let lastRediscoveryAt = null;
-        try {
-            const cached = await deps.cache.get(`rediscovery:lastRun:${state.userId}`);
-            if (typeof cached?.triggeredAt === 'string') {
-                const parsed = Date.parse(cached.triggeredAt);
-                if (Number.isFinite(parsed)) {
-                    lastRediscoveryAt = parsed;
-                }
-            }
-        }
-        catch {
-            // Cache unavailable — treat as no data
-        }
-        return {
-            currentOpportunities: actionable,
-            expiredCount: expired.length,
-            activeIntents: activeIntents ?? [],
-            lastRediscoveryAt,
-        };
-    }
-    catch (e) {
-        logger.error('MaintenanceGraph loadCurrentRadar failed', { error: e });
-        return { error: 'Failed to load current radar' };
-    }
-}
-export async function scoreRadarHealthNode(state) {
-    if (state.error)
-        return {};
-    try {
-        const opps = state.currentOpportunities ?? [];
-        let connectionCount = 0;
-        let connectorFlowCount = 0;
-        for (const opp of opps) {
-            const category = classifyOpportunity(opp, state.userId);
-            if (category === 'connection')
-                connectionCount++;
-            else if (category === 'connector-flow')
-                connectorFlowCount++;
-        }
-        const healthResult = computeRadarHealth({
-            connectionCount,
-            connectorFlowCount,
-            expiredCount: state.expiredCount,
-            totalActionable: opps.length,
-            lastRediscoveryAt: state.lastRediscoveryAt,
-            freshnessWindowMs: FRESHNESS_WINDOW_MS,
-        });
-        logger.verbose('Radar health scored', {
-            userId: state.userId,
-            score: healthResult.score,
-            shouldMaintain: healthResult.shouldMaintain,
-            connectorFlowCount,
-        });
-        return { healthResult, connectorFlowCount };
-    }
-    catch (e) {
-        logger.error('MaintenanceGraph scoreRadarHealth failed', { error: e });
-        return { error: 'Failed to score radar health' };
-    }
-}
-export function shouldRediscover(state) {
-    if (state.error)
-        return 'introducerDiscovery';
-    if (state.healthResult?.shouldMaintain && state.activeIntents.length > 0) {
-        return 'rediscover';
-    }
-    return 'introducerDiscovery';
-}
-export async function rediscoverNode(state, deps) {
-    try {
-        const bucket = Math.floor(Date.now() / (6 * 60 * 60 * 1000));
-        const results = await Promise.allSettled(state.activeIntents.map((intent) => deps.queue.addJob({ intentId: intent.id, userId: state.userId }, { priority: 10, jobId: `rediscovery-${state.userId}-${intent.id}-${bucket}` })));
-        for (const r of results) {
-            if (r.status === 'rejected') {
-                const errMsg = r.reason instanceof Error ? r.reason.message : String(r.reason);
-                logger.error('Rediscovery job enqueue failed', { error: errMsg });
-            }
-        }
-        const enqueued = results.filter((r) => r.status === 'fulfilled').length;
-        // Record last run timestamp
-        if (enqueued > 0) {
-            try {
-                await deps.cache.set(`rediscovery:lastRun:${state.userId}`, { triggeredAt: new Date().toISOString() }, { ttl: 24 * 60 * 60 });
-            }
-            catch {
-                // Cache write failure is non-fatal
-            }
-        }
-        return { rediscoveryJobsEnqueued: enqueued };
-    }
-    catch (e) {
-        logger.error('MaintenanceGraph rediscover failed', { error: e });
-        return { error: 'Failed to enqueue rediscovery jobs' };
-    }
-}
-export async function introducerDiscoveryNode(state, deps) {
-    if (!isIntroducerDiscoveryEnabled()) {
-        logger.info('Introducer discovery skipped — disabled by configuration', {
-            userId: state.userId,
-        });
-        return {};
-    }
-    try {
-        const connectorFlowTarget = RADAR_SOFT_TARGETS.connectorFlow;
-        if (!shouldRunIntroducerDiscovery(state.connectorFlowCount, connectorFlowTarget)) {
-            logger.verbose('Introducer discovery skipped — connector-flow target met', {
-                userId: state.userId,
-                connectorFlowCount: state.connectorFlowCount,
-                connectorFlowTarget,
-            });
-            return {};
-        }
-        // Cast database/queue to introducer discovery interfaces (they are compatible)
-        const result = await runIntroducerDiscovery(deps.database, deps.queue, state.userId);
-        logger.info('Introducer discovery complete', {
-            userId: state.userId,
-            contactsEvaluated: result.contactsEvaluated,
-            jobsEnqueued: result.jobsEnqueued,
-            skippedReason: result.skippedReason,
-        });
-        return { introducerDiscoveryJobsEnqueued: result.jobsEnqueued };
-    }
-    catch (e) {
-        logger.error('MaintenanceGraph introducerDiscovery failed', { error: e });
-        // Non-fatal: do not set error, just log and continue
-        return {};
-    }
-}
-export async function logMaintenanceNode(state) {
-    logger.info('Maintenance complete', {
-        userId: state.userId,
-        score: state.healthResult?.score,
-        shouldMaintain: state.healthResult?.shouldMaintain,
-        rediscoveryJobs: state.rediscoveryJobsEnqueued,
-        introducerDiscoveryJobs: state.introducerDiscoveryJobsEnqueued,
-        activeIntents: state.activeIntents.length,
-        connectorFlowCount: state.connectorFlowCount,
-    });
-    return {};
-}

package/dist/maintenance/maintenance.state.d.ts

@@ -1,35 +0,0 @@
-import type { Opportunity } from '../shared/interfaces/database.interface.js';
-import type { RadarHealthResult } from '../opportunities/radar/radar.health.js';
-/**
- * Maintenance Graph State (Annotation-based).
- * Flow: loadCurrentRadar → scoreRadarHealth → [conditional: rediscover | END] → logMaintenance → END
- */
-export declare const MaintenanceGraphState: import("@langchain/langgraph").AnnotationRoot<{
-    userId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
-    /** Active intents for the user (used for rediscovery). */
-    activeIntents: import("@langchain/langgraph").BaseChannel<{
-        id: string;
-        payload: string;
-    }[], {
-        id: string;
-        payload: string;
-    }[] | import("@langchain/langgraph").OverwriteValue<{
-        id: string;
-        payload: string;
-    }[]>, unknown>;
-    /** Current actionable opportunities for the user. */
-    currentOpportunities: import("@langchain/langgraph").BaseChannel<Opportunity[], Opportunity[] | import("@langchain/langgraph").OverwriteValue<Opportunity[]>, unknown>;
-    /** Current expired opportunities count. */
-    expiredCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    /** Unix ms timestamp of last rediscovery for this user. */
-    lastRediscoveryAt: import("@langchain/langgraph").BaseChannel<number | null, number | import("@langchain/langgraph").OverwriteValue<number | null> | null, unknown>;
-    /** Radar health score result. */
-    healthResult: import("@langchain/langgraph").BaseChannel<RadarHealthResult | null, RadarHealthResult | import("@langchain/langgraph").OverwriteValue<RadarHealthResult | null> | null, unknown>;
-    /** Number of rediscovery jobs enqueued. */
-    rediscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    /** Current connector-flow opportunity count (from scoreRadarHealth). */
-    connectorFlowCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    /** Number of introducer discovery jobs enqueued. */
-    introducerDiscoveryJobsEnqueued: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-}>;

package/dist/maintenance/maintenance.state.js

@@ -1,55 +0,0 @@
-import { Annotation } from '@langchain/langgraph';
-/**
- * Maintenance Graph State (Annotation-based).
- * Flow: loadCurrentRadar → scoreRadarHealth → [conditional: rediscover | END] → logMaintenance → END
- */
-export const MaintenanceGraphState = Annotation.Root({
-    userId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => '',
-    }),
-    /** Active intents for the user (used for rediscovery). */
-    activeIntents: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Current actionable opportunities for the user. */
-    currentOpportunities: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Current expired opportunities count. */
-    expiredCount: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 0,
-    }),
-    /** Unix ms timestamp of last rediscovery for this user. */
-    lastRediscoveryAt: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => null,
-    }),
-    /** Radar health score result. */
-    healthResult: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => null,
-    }),
-    /** Number of rediscovery jobs enqueued. */
-    rediscoveryJobsEnqueued: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 0,
-    }),
-    /** Current connector-flow opportunity count (from scoreRadarHealth). */
-    connectorFlowCount: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 0,
-    }),
-    /** Number of introducer discovery jobs enqueued. */
-    introducerDiscoveryJobsEnqueued: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 0,
-    }),
-    error: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-});

package/dist/mcp/elicitation.builder.d.ts

@@ -1,53 +0,0 @@
-import type { Question } from "../questions/question.schema.js";
-type SingleChoiceSchema = {
-    type: "string";
-    enum: string[];
-    description: string;
-};
-type MultiChoiceSchema = {
-    type: "array";
-    items: {
-        type: "string";
-        enum: string[];
-    };
-    description: string;
-};
-type ChoiceSchema = SingleChoiceSchema | MultiChoiceSchema;
-/**
- * Translates a Question into an MCP `elicitation/create` request payload.
- * The schema has one property named `choice` — a string-with-enum for
- * single-select, an array-of-enum-strings for multi-select.
- *
- * Per-option `description` text is packed into the property `description`
- * joined by ` | ` (MCP `requestedSchema` has no slot for per-option
- * descriptions; this is the spec's accepted lossy mapping).
- *
- * @param q - The question to translate.
- * @returns An MCP `elicitation/create` request payload.
- */
-export declare function buildElicitationCreate(q: Question): {
-    message: string;
-    requestedSchema: {
-        type: "object";
-        properties: {
-            choice: ChoiceSchema;
-        };
-        required: ["choice"];
-    };
-};
-/**
- * Flattens an accepted elicitation `choice` value into the user-message
- * format Slice 4 produces. Returns `null` when the choice is missing,
- * empty, or contains no values that match `q.options` — MCP clients can
- * be buggy or non-conformant, so values are validated against the
- * declared enum before being persisted as a user message.
- *
- * For multi-select questions, items that are not strings or not in the
- * options list are dropped silently; if no items remain, returns null.
- *
- * @param q - The question the choice answers.
- * @param choice - The raw value from the elicitation response.
- * @returns A formatted string or `null` if no valid choice remains.
- */
-export declare function flattenChoice(q: Question, choice: unknown): string | null;
-export {};

package/dist/mcp/elicitation.builder.js

@@ -1,74 +0,0 @@
-/**
- * Translates a Question into an MCP `elicitation/create` request payload.
- * The schema has one property named `choice` — a string-with-enum for
- * single-select, an array-of-enum-strings for multi-select.
- *
- * Per-option `description` text is packed into the property `description`
- * joined by ` | ` (MCP `requestedSchema` has no slot for per-option
- * descriptions; this is the spec's accepted lossy mapping).
- *
- * @param q - The question to translate.
- * @returns An MCP `elicitation/create` request payload.
- */
-export function buildElicitationCreate(q) {
-    const propertyDescription = q.options
-        .map((opt) => `${opt.label}: ${opt.description}`)
-        .join(" | ");
-    const labels = q.options.map((o) => o.label);
-    const choiceSchema = q.multiSelect
-        ? {
-            type: "array",
-            items: { type: "string", enum: labels },
-            description: propertyDescription,
-        }
-        : {
-            type: "string",
-            enum: labels,
-            description: propertyDescription,
-        };
-    return {
-        message: `${q.title}: ${q.prompt}`,
-        requestedSchema: {
-            type: "object",
-            properties: { choice: choiceSchema },
-            required: ["choice"],
-        },
-    };
-}
-/**
- * Flattens an accepted elicitation `choice` value into the user-message
- * format Slice 4 produces. Returns `null` when the choice is missing,
- * empty, or contains no values that match `q.options` — MCP clients can
- * be buggy or non-conformant, so values are validated against the
- * declared enum before being persisted as a user message.
- *
- * For multi-select questions, items that are not strings or not in the
- * options list are dropped silently; if no items remain, returns null.
- *
- * @param q - The question the choice answers.
- * @param choice - The raw value from the elicitation response.
- * @returns A formatted string or `null` if no valid choice remains.
- */
-export function flattenChoice(q, choice) {
-    const prefix = `${q.title} (${q.prompt})`;
-    const allowedLabels = new Set(q.options.map((o) => o.label));
-    if (Array.isArray(choice)) {
-        // Only multi-select questions accept arrays. A single-select question
-        // receiving an array means a non-conformant client — reject the response
-        // rather than recording an impossible multi-answer.
-        if (!q.multiSelect)
-            return null;
-        const validItems = choice.filter((c) => typeof c === "string" && allowedLabels.has(c));
-        if (validItems.length === 0)
-            return null;
-        return `${prefix}: ${validItems.join(", ")}`;
-    }
-    if (typeof choice === "string" && allowedLabels.has(choice)) {
-        // Symmetric guard: multi-select questions must receive arrays. A bare
-        // string here means a non-conformant client; reject for the same reason.
-        if (q.multiSelect)
-            return null;
-        return `${prefix}: ${choice}`;
-    }
-    return null;
-}