@indexnetwork/protocol 8.3.0-rc.424.1 → 8.4.0-rc.426.1

package/dist/opportunity/{feed/feed.graph.d.ts → radar/radar.graph.d.ts}

@@ -1,20 +1,22 @@
 /**
- * Home Graph: Build the opportunity home view with dynamic sections.
+ * Radar Graph: Build the opportunity radar view — a flat, presenter-texted
+ * list of opportunity cards for a viewer, optionally scoped to one intent.
  *
  * Independent of ChatGraph. Flow:
- * loadOpportunities → checkPresenterCache → [generateCardText if misses] → cachePresenterResults
- * → checkCategorizerCache → [categorizeDynamically if miss] → cacheCategorizerResults → normalizeAndSort
+ * loadOpportunities → checkPresenterCache → [generateCardText if misses]
+ * → cachePresenterResults → normalizeItems
  *
- * Uses OpportunityPresenter for card text and an LLM to categorize cards into dynamic sections
- * with titles and Lucide icon names. Caches presenter and categorizer results via OpportunityCache.
+ * Uses OpportunityPresenter for card text and caches presenter results via
+ * OpportunityCache. Responses are a flat `items` array; clients bucket by
+ * lifecycle status themselves.
  */
-import type { HomeGraphDatabase, OpportunityStatus } from '../../shared/interfaces/database.interface.js';
+import type { RadarGraphDatabase, OpportunityStatus } from '../../shared/interfaces/database.interface.js';
 import type { OpportunityCache } from '../../shared/interfaces/cache.interface.js';
-import { type HomeCardItem, type HomeSection, type HomeSectionProposal } from './feed.state.js';
+import { type RadarCardItem, type RadarResponseItem } from './radar.state.js';
 import type { DebugMetaAgent } from '../../capabilities/participant-agents.debug.facade.js';
-/** Database must satisfy both HomeGraphDatabase and presenter context (getProfile, getActiveIntents, getNetwork, getUser). */
-type HomeGraphDb = HomeGraphDatabase;
-export type HomeGraphInvokeInput = {
+/** Database must satisfy both RadarGraphDatabase and presenter context (getProfile, getActiveIntents, getNetwork, getUser). */
+type RadarGraphDb = RadarGraphDatabase;
+export type RadarGraphInvokeInput = {
     userId: string;
     networkId?: string;
     scopeType?: 'intent';
@@ -23,43 +25,42 @@ export type HomeGraphInvokeInput = {
     noCache?: boolean;
     /**
      * 'skeleton' returns immediately without LLM work: cached cards complete,
-     * uncached cards with identity fields only + `presentationPending: true`,
-     * single flat section (no categorizer). Meant as the fast first phase of a
-     * two-phase fetch — follow up with a full request to fill in the text.
+     * uncached cards with identity fields only + `presentationPending: true`.
+     * Meant as the fast first phase of a two-phase fetch — follow up with a
+     * full request to fill in the text.
      */
     presentation?: 'full' | 'skeleton';
     /**
-     * When set, filter loaded opportunities to these lifecycle statuses. Defaults to `DEFAULT_HOME_STATUSES`.
+     * When set, filter loaded opportunities to these lifecycle statuses. Defaults to `DEFAULT_RADAR_STATUSES`.
      * Explicit statuses switch the graph to "lifecycle view" mode: terminal/internal
      * statuses pass through (only latent/pending stay gated by viewer actionability),
-     * ordering is newest-first, and feed composition capping is skipped.
+     * ordering is newest-first, and composition capping is skipped.
      */
     statuses?: OpportunityStatus[];
 };
-export type HomeGraphInvokeResult = {
-    sections: HomeSection[];
+export type RadarGraphInvokeResult = {
+    items: RadarResponseItem[];
     meta: {
         totalOpportunities: number;
-        totalSections: number;
     };
     error?: string;
 };
-/** Default home-feed statuses: the lifecycle stages a viewer can act on today. */
-export declare const DEFAULT_HOME_STATUSES: OpportunityStatus[];
-/** Full status enumeration. Pass this to `HomeGraphInvokeInput.statuses` to restore pre-Issue-3 (unfiltered) behavior. */
+/** Default radar statuses: the lifecycle stages a viewer can act on today. */
+export declare const DEFAULT_RADAR_STATUSES: OpportunityStatus[];
+/** Full status enumeration. Pass this to `RadarGraphInvokeInput.statuses` to restore pre-Issue-3 (unfiltered) behavior. */
 export declare const ALL_OPPORTUNITY_STATUSES: OpportunityStatus[];
 /** Pure cache policy for presenter cards; degraded current-request copy retries later. */
-export declare function isHomePresentationCacheable(card: Pick<HomeCardItem, 'presentationPending' | '_presentationFallback' | 'name'>, status: OpportunityStatus | undefined): boolean;
+export declare function isRadarPresentationCacheable(card: Pick<RadarCardItem, 'presentationPending' | '_presentationFallback' | 'name'>, status: OpportunityStatus | undefined): boolean;
 /**
  * Strip leading narrator name from remark when the UI already prepends "Name: " to the chip.
  * Avoids duplication like "Yankı Ekin Yüksel: Yankı Ekin Yüksel introduced you two..."
  * Repeats until no leading name (handles "Name: Name rest").
  */
 export declare function stripLeadingNarratorName(remark: string, narratorName: string): string;
-export declare class HomeGraphFactory {
+export declare class RadarGraphFactory {
     private database;
     private cache;
-    constructor(database: HomeGraphDb, cache: OpportunityCache);
+    constructor(database: RadarGraphDb, cache: OpportunityCache);
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         userId: string;
         networkId: string | undefined;
@@ -70,16 +71,13 @@ export declare class HomeGraphFactory {
         presentation: "full" | "skeleton";
         statuses: OpportunityStatus[] | undefined;
         opportunities: import("../../shared/interfaces/database.interface.js").Opportunity[];
-        cards: HomeCardItem[];
-        sectionProposals: HomeSectionProposal[];
-        sections: HomeSection[];
-        cachedCards: Map<string, HomeCardItem>;
+        cards: RadarCardItem[];
+        items: RadarResponseItem[];
+        cachedCards: Map<string, RadarCardItem>;
         uncachedOpportunities: import("../../shared/interfaces/database.interface.js").Opportunity[];
-        categoryCacheHit: boolean;
         error: string | undefined;
         meta: {
             totalOpportunities: number;
-            totalSections: number;
         };
         agentTimings: DebugMetaAgent[];
     }, {
@@ -92,22 +90,18 @@ export declare class HomeGraphFactory {
         presentation?: "full" | "skeleton" | import("@langchain/langgraph").OverwriteValue<"full" | "skeleton"> | undefined;
         statuses?: OpportunityStatus[] | import("@langchain/langgraph").OverwriteValue<OpportunityStatus[] | undefined> | undefined;
         opportunities?: import("../../shared/interfaces/database.interface.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../../shared/interfaces/database.interface.js").Opportunity[]> | undefined;
-        cards?: HomeCardItem[] | import("@langchain/langgraph").OverwriteValue<HomeCardItem[]> | undefined;
-        sectionProposals?: HomeSectionProposal[] | import("@langchain/langgraph").OverwriteValue<HomeSectionProposal[]> | undefined;
-        sections?: HomeSection[] | import("@langchain/langgraph").OverwriteValue<HomeSection[]> | undefined;
-        cachedCards?: Map<string, HomeCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, HomeCardItem>> | undefined;
+        cards?: RadarCardItem[] | import("@langchain/langgraph").OverwriteValue<RadarCardItem[]> | undefined;
+        items?: RadarResponseItem[] | import("@langchain/langgraph").OverwriteValue<RadarResponseItem[]> | undefined;
+        cachedCards?: Map<string, RadarCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, RadarCardItem>> | undefined;
         uncachedOpportunities?: import("../../shared/interfaces/database.interface.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../../shared/interfaces/database.interface.js").Opportunity[]> | undefined;
-        categoryCacheHit?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         meta?: {
             totalOpportunities: number;
-            totalSections: number;
         } | import("@langchain/langgraph").OverwriteValue<{
             totalOpportunities: number;
-            totalSections: number;
         }> | undefined;
         agentTimings?: DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]> | undefined;
-    }, "__start__" | "loadOpportunities" | "checkPresenterCache" | "generateCardText" | "cachePresenterResults" | "checkCategorizerCache" | "categorizeDynamically" | "cacheCategorizerResults" | "normalizeAndSort", {
+    }, "__start__" | "loadOpportunities" | "checkPresenterCache" | "generateCardText" | "cachePresenterResults" | "normalizeItems", {
         userId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<"intent" | undefined, "intent" | import("@langchain/langgraph").OverwriteValue<"intent" | undefined> | undefined, unknown>;
@@ -117,22 +111,17 @@ export declare class HomeGraphFactory {
         presentation: import("@langchain/langgraph").BaseChannel<"full" | "skeleton", "full" | "skeleton" | import("@langchain/langgraph").OverwriteValue<"full" | "skeleton">, unknown>;
         statuses: import("@langchain/langgraph").BaseChannel<OpportunityStatus[] | undefined, OpportunityStatus[] | import("@langchain/langgraph").OverwriteValue<OpportunityStatus[] | undefined> | undefined, unknown>;
         opportunities: import("@langchain/langgraph").BaseChannel<import("../../shared/interfaces/database.interface.js").Opportunity[], import("../../shared/interfaces/database.interface.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../../shared/interfaces/database.interface.js").Opportunity[]>, unknown>;
-        cards: import("@langchain/langgraph").BaseChannel<HomeCardItem[], HomeCardItem[] | import("@langchain/langgraph").OverwriteValue<HomeCardItem[]>, unknown>;
-        sectionProposals: import("@langchain/langgraph").BaseChannel<HomeSectionProposal[], HomeSectionProposal[] | import("@langchain/langgraph").OverwriteValue<HomeSectionProposal[]>, unknown>;
-        sections: import("@langchain/langgraph").BaseChannel<HomeSection[], HomeSection[] | import("@langchain/langgraph").OverwriteValue<HomeSection[]>, unknown>;
-        cachedCards: import("@langchain/langgraph").BaseChannel<Map<string, HomeCardItem>, Map<string, HomeCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, HomeCardItem>>, unknown>;
+        cards: import("@langchain/langgraph").BaseChannel<RadarCardItem[], RadarCardItem[] | import("@langchain/langgraph").OverwriteValue<RadarCardItem[]>, unknown>;
+        items: import("@langchain/langgraph").BaseChannel<RadarResponseItem[], RadarResponseItem[] | import("@langchain/langgraph").OverwriteValue<RadarResponseItem[]>, unknown>;
+        cachedCards: import("@langchain/langgraph").BaseChannel<Map<string, RadarCardItem>, Map<string, RadarCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, RadarCardItem>>, unknown>;
         uncachedOpportunities: import("@langchain/langgraph").BaseChannel<import("../../shared/interfaces/database.interface.js").Opportunity[], import("../../shared/interfaces/database.interface.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../../shared/interfaces/database.interface.js").Opportunity[]>, unknown>;
-        categoryCacheHit: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         meta: import("@langchain/langgraph").BaseChannel<{
             totalOpportunities: number;
-            totalSections: number;
         }, {
             totalOpportunities: number;
-            totalSections: number;
         } | import("@langchain/langgraph").OverwriteValue<{
             totalOpportunities: number;
-            totalSections: number;
         }>, unknown>;
         agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
     }, {
@@ -145,22 +134,17 @@ export declare class HomeGraphFactory {
         presentation: import("@langchain/langgraph").BaseChannel<"full" | "skeleton", "full" | "skeleton" | import("@langchain/langgraph").OverwriteValue<"full" | "skeleton">, unknown>;
         statuses: import("@langchain/langgraph").BaseChannel<OpportunityStatus[] | undefined, OpportunityStatus[] | import("@langchain/langgraph").OverwriteValue<OpportunityStatus[] | undefined> | undefined, unknown>;
         opportunities: import("@langchain/langgraph").BaseChannel<import("../../shared/interfaces/database.interface.js").Opportunity[], import("../../shared/interfaces/database.interface.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../../shared/interfaces/database.interface.js").Opportunity[]>, unknown>;
-        cards: import("@langchain/langgraph").BaseChannel<HomeCardItem[], HomeCardItem[] | import("@langchain/langgraph").OverwriteValue<HomeCardItem[]>, unknown>;
-        sectionProposals: import("@langchain/langgraph").BaseChannel<HomeSectionProposal[], HomeSectionProposal[] | import("@langchain/langgraph").OverwriteValue<HomeSectionProposal[]>, unknown>;
-        sections: import("@langchain/langgraph").BaseChannel<HomeSection[], HomeSection[] | import("@langchain/langgraph").OverwriteValue<HomeSection[]>, unknown>;
-        cachedCards: import("@langchain/langgraph").BaseChannel<Map<string, HomeCardItem>, Map<string, HomeCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, HomeCardItem>>, unknown>;
+        cards: import("@langchain/langgraph").BaseChannel<RadarCardItem[], RadarCardItem[] | import("@langchain/langgraph").OverwriteValue<RadarCardItem[]>, unknown>;
+        items: import("@langchain/langgraph").BaseChannel<RadarResponseItem[], RadarResponseItem[] | import("@langchain/langgraph").OverwriteValue<RadarResponseItem[]>, unknown>;
+        cachedCards: import("@langchain/langgraph").BaseChannel<Map<string, RadarCardItem>, Map<string, RadarCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, RadarCardItem>>, unknown>;
         uncachedOpportunities: import("@langchain/langgraph").BaseChannel<import("../../shared/interfaces/database.interface.js").Opportunity[], import("../../shared/interfaces/database.interface.js").Opportunity[] | import("@langchain/langgraph").OverwriteValue<import("../../shared/interfaces/database.interface.js").Opportunity[]>, unknown>;
-        categoryCacheHit: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         meta: import("@langchain/langgraph").BaseChannel<{
             totalOpportunities: number;
-            totalSections: number;
         }, {
             totalOpportunities: number;
-            totalSections: number;
         } | import("@langchain/langgraph").OverwriteValue<{
             totalOpportunities: number;
-            totalSections: number;
         }>, unknown>;
         agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
     }, import("@langchain/langgraph").StateDefinition, {
@@ -179,37 +163,22 @@ export declare class HomeGraphFactory {
             uncachedOpportunities: import("../../shared/interfaces/database.interface.js").Opportunity[];
         };
         generateCardText: {
-            cards: HomeCardItem[];
+            cards: RadarCardItem[];
             agentTimings: DebugMetaAgent[];
             meta: {
                 totalOpportunities: number;
-                totalSections: number;
             };
         };
         cachePresenterResults: {
-            cards: HomeCardItem[];
+            cards: RadarCardItem[];
             meta: {
                 totalOpportunities: number;
-                totalSections: number;
             };
         };
-        checkCategorizerCache: {
-            categoryCacheHit: boolean;
-            sectionProposals?: undefined;
-        } | {
-            sectionProposals: HomeSectionProposal[];
-            categoryCacheHit: boolean;
-        };
-        categorizeDynamically: {
-            sectionProposals: HomeSectionProposal[];
-            agentTimings: DebugMetaAgent[];
-        };
-        cacheCategorizerResults: {};
-        normalizeAndSort: {
-            sections: HomeSection[];
+        normalizeItems: {
+            items: RadarResponseItem[];
             meta: {
                 totalOpportunities: number;
-                totalSections: number;
             };
         };
     }, unknown, unknown, []>;