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

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

@@ -1,9 +1,9 @@
 import type { Opportunity, OpportunityStatus } from '../../shared/interfaces/database.interface.js';
 import type { DebugMetaAgent } from '../../capabilities/participant-agents.debug.facade.js';
 /**
- * Home view card item: one opportunity with full presenter-driven display contract.
+ * Radar card item: one opportunity with full presenter-driven display contract.
  */
-export interface HomeCardItem {
+export interface RadarCardItem {
     opportunityId: string;
     /** Lifecycle status of the underlying opportunity at render time (client bucketing, e.g. intent radar). */
     status?: OpportunityStatus;
@@ -46,77 +46,51 @@ export interface HomeCardItem {
     presentationPending?: boolean;
     /** Internal marker: safe deterministic fallback rendered, but must not be cached. */
     _presentationFallback?: boolean;
-    /** For section assignment from LLM */
+    /** Internal: original position in the loaded opportunity list, for stable ordering. */
     _cardIndex: number;
 }
+/** Card item as returned in API responses (no internal fields). */
+export type RadarResponseItem = Omit<RadarCardItem, '_cardIndex' | '_presentationFallback'>;
 /**
- * Dynamic section from LLM categorization.
+ * Radar Graph State (Annotation-based).
+ * Flow: loadOpportunities → checkPresenterCache → [generateCardText if misses]
+ * → cachePresenterResults → normalizeItems.
  */
-export interface HomeSectionProposal {
-    id: string;
-    title: string;
-    subtitle?: string;
-    iconName: string;
-    itemIndices: number[];
-}
-/** Card item as returned in API (no internal _cardIndex). */
-export type HomeSectionItem = Omit<HomeCardItem, '_cardIndex' | '_presentationFallback'>;
-/**
- * Final section for API response.
- */
-export interface HomeSection {
-    id: string;
-    title: string;
-    subtitle?: string;
-    iconName: string;
-    items: HomeSectionItem[];
-}
-/**
- * Home Graph State (Annotation-based).
- * Flow: loadOpportunities → generateCardText → categorizeDynamically → normalizeAndSort → finalizeResponse.
- */
-export declare const HomeGraphState: import("@langchain/langgraph").AnnotationRoot<{
+export declare const RadarGraphState: import("@langchain/langgraph").AnnotationRoot<{
     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>;
     scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
     limit: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    /** When true, bypass presenter and categorizer Redis caches. */
+    /** When true, bypass the presenter Redis cache. */
     noCache: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
     /**
-     * Presentation depth. 'full' (default) runs the presenter LLM and categorizer.
-     * 'skeleton' skips both for cache misses: uncached cards come back with
-     * resolved identity (name/avatar/status) and `presentationPending: true`,
-     * cached cards come back complete, and all cards land in one flat section.
+     * Presentation depth. 'full' (default) runs the presenter LLM for cache
+     * misses. 'skeleton' skips it: uncached cards come back with resolved
+     * identity (name/avatar/status) and `presentationPending: true`, cached
+     * cards come back complete.
      */
     presentation: import("@langchain/langgraph").BaseChannel<"full" | "skeleton", "full" | "skeleton" | import("@langchain/langgraph").OverwriteValue<"full" | "skeleton">, unknown>;
-    /** Optional status filter. When undefined, the graph uses `DEFAULT_HOME_STATUSES`. */
+    /** Optional status filter. When undefined, the graph uses `DEFAULT_RADAR_STATUSES`. */
     statuses: import("@langchain/langgraph").BaseChannel<OpportunityStatus[] | undefined, OpportunityStatus[] | import("@langchain/langgraph").OverwriteValue<OpportunityStatus[] | undefined> | undefined, unknown>;
     /** Raw opportunities visible to the viewer (after visibility filter). */
     opportunities: import("@langchain/langgraph").BaseChannel<Opportunity[], Opportunity[] | import("@langchain/langgraph").OverwriteValue<Opportunity[]>, unknown>;
     /** Cards with presenter output and narrator chip. */
-    cards: import("@langchain/langgraph").BaseChannel<HomeCardItem[], HomeCardItem[] | import("@langchain/langgraph").OverwriteValue<HomeCardItem[]>, unknown>;
-    /** LLM output: dynamic sections with icon and item indices. */
-    sectionProposals: import("@langchain/langgraph").BaseChannel<HomeSectionProposal[], HomeSectionProposal[] | import("@langchain/langgraph").OverwriteValue<HomeSectionProposal[]>, unknown>;
-    /** Final sections for response. */
-    sections: import("@langchain/langgraph").BaseChannel<HomeSection[], HomeSection[] | import("@langchain/langgraph").OverwriteValue<HomeSection[]>, unknown>;
-    /** Presenter results retrieved from cache (opportunityId → HomeCardItem). */
-    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>;
+    /** Final items for response (internal fields stripped). */
+    items: import("@langchain/langgraph").BaseChannel<RadarResponseItem[], RadarResponseItem[] | import("@langchain/langgraph").OverwriteValue<RadarResponseItem[]>, unknown>;
+    /** Presenter results retrieved from cache (opportunityId → RadarCardItem). */
+    cachedCards: import("@langchain/langgraph").BaseChannel<Map<string, RadarCardItem>, Map<string, RadarCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, RadarCardItem>>, unknown>;
     /** Opportunities that had no cache hit and need presenter generation. */
     uncachedOpportunities: import("@langchain/langgraph").BaseChannel<Opportunity[], Opportunity[] | import("@langchain/langgraph").OverwriteValue<Opportunity[]>, unknown>;
-    /** Whether categorizer results were found in cache. */
-    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 for response (e.g. totalOpportunities, totalSections). */
+    /** Meta for response (e.g. totalOpportunities). */
     meta: import("@langchain/langgraph").BaseChannel<{
         totalOpportunities: number;
-        totalSections: number;
     }, {
         totalOpportunities: number;
-        totalSections: number;
     } | import("@langchain/langgraph").OverwriteValue<{
         totalOpportunities: number;
-        totalSections: number;
     }>, unknown>;
     /** Timing records for each agent invocation within this graph run. */
     agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;

package/dist/opportunity/{feed/feed.state.js → radar/radar.state.js}

@@ -1,9 +1,10 @@
 import { Annotation } from '@langchain/langgraph';
 /**
- * Home Graph State (Annotation-based).
- * Flow: loadOpportunities → generateCardText → categorizeDynamically → normalizeAndSort → finalizeResponse.
+ * Radar Graph State (Annotation-based).
+ * Flow: loadOpportunities → checkPresenterCache → [generateCardText if misses]
+ * → cachePresenterResults → normalizeItems.
  */
-export const HomeGraphState = Annotation.Root({
+export const RadarGraphState = Annotation.Root({
     userId: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => '',
@@ -24,22 +25,22 @@ export const HomeGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => 50,
     }),
-    /** When true, bypass presenter and categorizer Redis caches. */
+    /** When true, bypass the presenter Redis cache. */
     noCache: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => false,
     }),
     /**
-     * Presentation depth. 'full' (default) runs the presenter LLM and categorizer.
-     * 'skeleton' skips both for cache misses: uncached cards come back with
-     * resolved identity (name/avatar/status) and `presentationPending: true`,
-     * cached cards come back complete, and all cards land in one flat section.
+     * Presentation depth. 'full' (default) runs the presenter LLM for cache
+     * misses. 'skeleton' skips it: uncached cards come back with resolved
+     * identity (name/avatar/status) and `presentationPending: true`, cached
+     * cards come back complete.
      */
     presentation: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => 'full',
     }),
-    /** Optional status filter. When undefined, the graph uses `DEFAULT_HOME_STATUSES`. */
+    /** Optional status filter. When undefined, the graph uses `DEFAULT_RADAR_STATUSES`. */
     statuses: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => undefined,
@@ -54,17 +55,12 @@ export const HomeGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => [],
     }),
-    /** LLM output: dynamic sections with icon and item indices. */
-    sectionProposals: Annotation({
+    /** Final items for response (internal fields stripped). */
+    items: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => [],
     }),
-    /** Final sections for response. */
-    sections: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Presenter results retrieved from cache (opportunityId → HomeCardItem). */
+    /** Presenter results retrieved from cache (opportunityId → RadarCardItem). */
     cachedCards: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => new Map(),
@@ -74,19 +70,14 @@ export const HomeGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => [],
     }),
-    /** Whether categorizer results were found in cache. */
-    categoryCacheHit: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => false,
-    }),
     error: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => undefined,
     }),
-    /** Meta for response (e.g. totalOpportunities, totalSections). */
+    /** Meta for response (e.g. totalOpportunities). */
     meta: Annotation({
         reducer: (curr, next) => next ?? curr,
-        default: () => ({ totalOpportunities: 0, totalSections: 0 }),
+        default: () => ({ totalOpportunities: 0 }),
     }),
     /** Timing records for each agent invocation within this graph run. */
     agentTimings: Annotation({

package/dist/shared/agent/tool.helpers.d.ts

@@ -425,7 +425,7 @@ interface ToolDepsBindings {
      */
     opportunityPresentation?: {
         createPresenter?: () => {
-            presentHomeCard(input: unknown): Promise<unknown>;
+            presentCard(input: unknown): Promise<unknown>;
         };
         gatherPresenterContext?: (...args: unknown[]) => Promise<unknown>;
     };

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

@@ -537,7 +537,7 @@ export interface OpportunityQueryOptions {
     role?: string;
     limit?: number;
     offset?: number;
-    /** When set, include draft opportunities for this chat session. When unset, exclude all draft opportunities (e.g. home view, API). */
+    /** When set, include draft opportunities for this chat session. When unset, exclude all draft opportunities (e.g. radar view, API). */
     conversationId?: string;
 }
 /**
@@ -2284,9 +2284,9 @@ export type NetworkMembershipGraphDatabase = Pick<Database, 'isNetworkMember' |
  */
 export type HydeGraphDatabase = Pick<Database, 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent'>;
 /**
- * Database interface for Home Graph (opportunity home view).
+ * 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 HomeGraphDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & Pick<NegotiationGraphDatabase, 'getNegotiationTaskForOpportunity' | 'getMessagesForConversation' | 'getArtifactsForTask'>;
+export type RadarGraphDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & Pick<NegotiationGraphDatabase, 'getNegotiationTaskForOpportunity' | 'getMessagesForConversation' | 'getArtifactsForTask'>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "8.3.0-rc.424.1",
+  "version": "8.4.0-rc.426.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/opportunity/feed/feed.categorizer.d.ts

@@ -1,27 +0,0 @@
-/**
- * Home Categorizer Agent
- *
- * Takes a list of presenter-produced opportunity cards and returns dynamic sections
- * with CTA-style titles and Lucide icon names. Used by the home graph after
- * generateCardText.
- */
-import type { HomeSectionProposal } from './feed.state.js';
-export type CategorizerInputItem = {
-    index: number;
-    headline?: string;
-    mainText: string;
-    name: string;
-    viewerRole?: string;
-    opportunityStatus?: string;
-};
-export type CategorizerResult = {
-    sections: HomeSectionProposal[];
-};
-export declare class HomeCategorizerAgent {
-    private model;
-    constructor();
-    /**
-     * Categorize presenter-produced cards into 1–5 sections with CTA-style titles and icons.
-     */
-    categorize(cards: CategorizerInputItem[]): Promise<CategorizerResult>;
-}

package/dist/opportunity/feed/feed.categorizer.js

@@ -1,168 +0,0 @@
-/**
- * Home Categorizer Agent
- *
- * Takes a list of presenter-produced opportunity cards and returns dynamic sections
- * with CTA-style titles and Lucide icon names. Used by the home graph after
- * generateCardText.
- */
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-import { HumanMessage, SystemMessage } from '@langchain/core/messages';
-import { z } from 'zod';
-import { getIconNamesForPrompt, DEFAULT_HOME_SECTION_ICON } from '../../shared/ui/lucide.icon-catalog.js';
-import { protocolLogger } from '../../shared/observability/protocol.logger.js';
-import { Timed } from "../../shared/observability/performance.js";
-import { createStructuredModel } from "../../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
-import { hasUnsupportedOpportunityClaim } from '../opportunity.claim-safety.js';
-const logger = protocolLogger('HomeCategorizer');
-const categorizationSchema = z.object({
-    sections: z.array(z.object({
-        id: z.string().describe('Short kebab-case id for the section'),
-        title: z
-            .string()
-            .describe('Call-to-action style section heading (e.g. REACH OUT NOW, YOUR MOVE, CONNECTIONS WAITING FOR YOU)'),
-        subtitle: z.string().nullable().describe('Optional one-line description; use null if none'),
-        iconName: z.string().describe('Lucide icon name in kebab-case from the allowed list'),
-        itemIndices: z.array(z.number()).describe('Indices of cards in this section (0-based)'),
-    })),
-});
-const UNCATEGORIZED_SECTION_ID = 'uncategorized';
-const UNCATEGORIZED_SECTION_TITLE = 'UNCATEGORIZED OPPORTUNITIES';
-/** Single-section fallback grouping every card under one generic heading. */
-function buildFallbackResult(cards) {
-    return {
-        sections: [
-            {
-                id: 'opportunities',
-                title: 'OPPORTUNITIES',
-                iconName: DEFAULT_HOME_SECTION_ICON,
-                itemIndices: cards.map((c) => c.index),
-            },
-        ],
-    };
-}
-/**
- * Build card summaries for the categorizer prompt.
- */
-function buildCardSummaries(cards) {
-    return cards
-        .map((c) => {
-        const role = c.viewerRole ?? 'party';
-        const status = c.opportunityStatus ?? 'pending';
-        return `[${c.index}] role=${role}; status=${status}; ${c.headline ?? c.mainText.slice(0, 60)}... (${c.name})`;
-    })
-        .join('\n');
-}
-function reconcileSections(sections, maxIndex) {
-    const assigned = new Set();
-    const normalizedSections = sections.map((section) => {
-        const uniqueIndices = Array.from(new Set(section.itemIndices.filter((index) => index >= 0 && index <= maxIndex))).sort((a, b) => a - b);
-        for (const index of uniqueIndices) {
-            assigned.add(index);
-        }
-        return {
-            ...section,
-            itemIndices: uniqueIndices,
-        };
-    });
-    const missingIndices = [];
-    for (let index = 0; index <= maxIndex; index += 1) {
-        if (!assigned.has(index)) {
-            missingIndices.push(index);
-        }
-    }
-    if (missingIndices.length === 0) {
-        return normalizedSections;
-    }
-    const fallbackSection = normalizedSections.find((section) => section.id === UNCATEGORIZED_SECTION_ID);
-    if (fallbackSection) {
-        fallbackSection.itemIndices = Array.from(new Set([...fallbackSection.itemIndices, ...missingIndices])).sort((a, b) => a - b);
-        return normalizedSections;
-    }
-    return [
-        ...normalizedSections,
-        {
-            id: UNCATEGORIZED_SECTION_ID,
-            title: UNCATEGORIZED_SECTION_TITLE,
-            iconName: DEFAULT_HOME_SECTION_ICON,
-            itemIndices: missingIndices,
-        },
-    ];
-}
-export class HomeCategorizerAgent {
-    constructor() {
-        this.model = createStructuredModel("homeCategorizer", categorizationSchema, { name: 'home_sections' });
-    }
-    /**
-     * Categorize presenter-produced cards into 1–5 sections with CTA-style titles and icons.
-     */
-    async categorize(cards) {
-        if (cards.length === 0) {
-            return { sections: [] };
-        }
-        const iconList = getIconNamesForPrompt();
-        const cardSummaries = buildCardSummaries(cards);
-        const maxIndex = cards.length - 1;
-        const systemPrompt = `You are organizing connection opportunities into dynamic sections for a user's home feed.
-
-Given a list of opportunity cards (each with index, headline/summary, and name), group them into 1–5 sections.
-
-Each section must have:
-- id: short kebab-case identifier (e.g. waiting-for-action, your-perspective, connector)
-- title: CALL-TO-ACTION style section heading in uppercase. Write as an action or invitation, not a neutral label. Examples: REACH OUT NOW, YOUR MOVE, CONNECTIONS WAITING FOR YOU, INTROS READY TO SEND, PEOPLE YOU SHOULD MEET
-- subtitle: optional one-line description
-- iconName: exactly ONE icon from this list (use the name as-is): ${iconList}
-- itemIndices: array of card indices that belong in this section (each index 0 to ${maxIndex} at most once)
-
-Rules:
-- Use only icon names from the list above.
-- Every card index must appear in exactly one section.
-- Section titles must read as calls-to-action or invitations, not passive labels.
-- If a card has role=introducer and status=pending, prioritize grouping those cards under a connector curation section with a CTA title like "YOU'RE THE CONNECTOR THEY NEED", "MAKE THE INTRO", or "DECIDE IF IT'S A GOOD MATCH".`;
-        const userContent = `Cards to categorize:\n${cardSummaries}\n\nOutput sections with id, title (CTA-style), subtitle (optional), iconName, and itemIndices.`;
-        try {
-            const result = await invokeWithAbortSignal(this.model, [
-                new SystemMessage(systemPrompt),
-                new HumanMessage(userContent),
-            ]);
-            const parsed = categorizationSchema.safeParse(result);
-            if (!parsed.success) {
-                logger.warn('HomeCategorizer parse failed', { error: parsed.error });
-                return buildFallbackResult(cards);
-            }
-            const sections = parsed.data.sections.map((s) => ({
-                id: s.id,
-                title: s.title,
-                subtitle: s.subtitle ?? undefined,
-                iconName: s.iconName,
-                itemIndices: s.itemIndices.filter((i) => i >= 0 && i <= maxIndex),
-            }));
-            if (sections.some((section) => hasUnsupportedOpportunityClaim(section.title)
-                || hasUnsupportedOpportunityClaim(section.subtitle))) {
-                logger.warn('HomeCategorizer emitted unsupported affiliation/presence claim; using fallback');
-                return buildFallbackResult(cards);
-            }
-            const reconciledSections = reconcileSections(sections, maxIndex);
-            return { sections: reconciledSections };
-        }
-        catch (e) {
-            const err = e instanceof Error ? { message: e.message, name: e.name } : String(e);
-            logger.error('HomeCategorizer categorize failed', { error: err });
-            return buildFallbackResult(cards);
-        }
-    }
-}
-__decorate([
-    Timed(),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Array]),
-    __metadata("design:returntype", Promise)
-], HomeCategorizerAgent.prototype, "categorize", null);

package/dist/shared/ui/lucide.icon-catalog.d.ts

@@ -1,21 +0,0 @@
-/**
- * Lucide icon catalog for home view section headings.
- * Icon names are kebab-case for use with lucide-react DynamicIcon (name prop).
- * Used by home graph LLM to pick an icon per dynamic section.
- */
-/** Default icon when LLM returns invalid or missing icon name. */
-export declare const DEFAULT_HOME_SECTION_ICON = "hourglass";
-/** Allowed icon names for home sections (subset of Lucide icons). */
-export declare const HOME_SECTION_ICON_NAMES: readonly string[];
-/**
- * Normalize icon name: lowercase, strip spaces (allow kebab-case from LLM).
- */
-export declare function normalizeIconName(name: string | undefined | null): string;
-/**
- * Validate and return an allowed icon name; fallback to default if unknown.
- */
-export declare function resolveHomeSectionIcon(name: string | undefined | null): string;
-/**
- * Return a formatted list of icon names for LLM prompts (comma-separated, truncated if needed).
- */
-export declare function getIconNamesForPrompt(maxItems?: number): string;

package/dist/shared/ui/lucide.icon-catalog.js

@@ -1,100 +0,0 @@
-/**
- * Lucide icon catalog for home view section headings.
- * Icon names are kebab-case for use with lucide-react DynamicIcon (name prop).
- * Used by home graph LLM to pick an icon per dynamic section.
- */
-/** Default icon when LLM returns invalid or missing icon name. */
-export const DEFAULT_HOME_SECTION_ICON = 'hourglass';
-/** Allowed icon names for home sections (subset of Lucide icons). */
-export const HOME_SECTION_ICON_NAMES = [
-    'hourglass',
-    'telescope',
-    'route',
-    'bot',
-    'user',
-    'users',
-    'message-circle',
-    'sparkles',
-    'handshake',
-    'target',
-    'zap',
-    'lightbulb',
-    'compass',
-    'globe',
-    'heart',
-    'star',
-    'trending-up',
-    'briefcase',
-    'rocket',
-    'search',
-    'filter',
-    'list',
-    'layout-grid',
-    'inbox',
-    'send',
-    'mail',
-    'calendar',
-    'clock',
-    'timer',
-    'flag',
-    'bookmark',
-    'link',
-    'share-2',
-    'thumbs-up',
-    'award',
-    'graduation-cap',
-    'building-2',
-    'network',
-    'git-branch',
-    'code',
-    'palette',
-    'pen-tool',
-    'folder',
-    'file-text',
-    'bar-chart',
-    'pie-chart',
-    'activity',
-    'arrow-right',
-    'chevron-right',
-    'circle-dot',
-    'circle-user',
-    'user-plus',
-    'user-check',
-    'users-round',
-    'hand',
-    'hand-metal',
-    'megaphone',
-    'bell',
-    'eye',
-    'eye-off',
-    'lock',
-    'unlock',
-    'shield',
-    'shield-check',
-];
-const ALLOWED_SET = new Set(HOME_SECTION_ICON_NAMES);
-/**
- * Normalize icon name: lowercase, strip spaces (allow kebab-case from LLM).
- */
-export function normalizeIconName(name) {
-    if (name == null || typeof name !== 'string')
-        return DEFAULT_HOME_SECTION_ICON;
-    const normalized = name.trim().toLowerCase().replace(/\s+/g, '-');
-    if (!normalized)
-        return DEFAULT_HOME_SECTION_ICON;
-    return normalized;
-}
-/**
- * Validate and return an allowed icon name; fallback to default if unknown.
- */
-export function resolveHomeSectionIcon(name) {
-    const normalized = normalizeIconName(name);
-    return ALLOWED_SET.has(normalized) ? normalized : DEFAULT_HOME_SECTION_ICON;
-}
-/**
- * Return a formatted list of icon names for LLM prompts (comma-separated, truncated if needed).
- */
-export function getIconNamesForPrompt(maxItems = 60) {
-    const list = HOME_SECTION_ICON_NAMES.slice(0, maxItems);
-    return list.join(', ');
-}