@indexnetwork/protocol 0.1.0

package/dist/support/log.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Protocol-internal logging module.
+ *
+ * Self-contained — no imports from outside the protocol library.
+ * Ships with a minimal console-based default. The host application can
+ * call `setLoggerFactory()` at startup to wire in a richer implementation
+ * (e.g. the project-wide `log` utility with ANSI colors, context filtering,
+ * and embedding redaction).
+ */
+type LogMethod = (message: string, meta?: Record<string, unknown>) => void;
+export type LoggerWithSource = {
+    verbose: LogMethod;
+    debug: LogMethod;
+    info: LogMethod;
+    warn: LogMethod;
+    error: LogMethod;
+};
+export type LogContext = 'protocol' | 'lib' | 'agent' | 'graph';
+export type LogLevel = 'verbose' | 'debug' | 'info' | 'warn' | 'error';
+type LoggerFactory = (context: string, source: string) => LoggerWithSource;
+type SanitizeFn = (value: unknown) => unknown;
+/**
+ * Override the logger factory used by all protocol-internal logging.
+ * Call this at application startup to wire in your project's logger.
+ *
+ * @example
+ * ```ts
+ * import { log, sanitizeForLog } from "./lib/log.js";
+ * import { setLoggerFactory } from "./lib/protocol/support/log.js";
+ *
+ * setLoggerFactory(
+ *   (context, source) => log.withContext(context as LogContext, source),
+ *   sanitizeForLog,
+ * );
+ * ```
+ */
+export declare function setLoggerFactory(factory: LoggerFactory, sanitize?: SanitizeFn): void;
+/** Sanitize an object for logging (redacts embeddings when host logger is wired in). */
+export declare function sanitizeForLog(value: unknown): unknown;
+/**
+ * Logger with pre-bound context. Usage:
+ * ```ts
+ * const logger = log.protocol.from('MyComponent');
+ * logger.info('started');
+ * ```
+ *
+ * Logger creation is deferred to call time so `setLoggerFactory()` can be
+ * called at app startup and all subsequent `.from()` calls use the new factory.
+ */
+export declare const log: {
+    protocol: {
+        from: (source: string) => LoggerWithSource;
+    };
+    lib: {
+        from: (source: string) => LoggerWithSource;
+    };
+    agent: {
+        from: (source: string) => LoggerWithSource;
+    };
+    graph: {
+        from: (source: string) => LoggerWithSource;
+    };
+};
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/support/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/support/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,KAAK,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAE3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAyBvE,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAC3E,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;AAK9C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,UAAU,QAG7E;AAMD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAQD;;;;;;;;;GASG;AACH,eAAO,MAAM,GAAG;;uBAdG,MAAM;;;uBAAN,MAAM;;;uBAAN,MAAM;;;uBAAN,MAAM;;CAmBxB,CAAC"}

package/dist/support/log.js

@@ -0,0 +1,76 @@
+/**
+ * Protocol-internal logging module.
+ *
+ * Self-contained — no imports from outside the protocol library.
+ * Ships with a minimal console-based default. The host application can
+ * call `setLoggerFactory()` at startup to wire in a richer implementation
+ * (e.g. the project-wide `log` utility with ANSI colors, context filtering,
+ * and embedding redaction).
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEFAULT IMPLEMENTATION
+// ═══════════════════════════════════════════════════════════════════════════════
+function defaultCreateLogger(_context, source) {
+    const prefix = `[${source}]`;
+    return {
+        verbose: (msg, meta) => console.debug(prefix, msg, ...(meta ? [meta] : [])),
+        debug: (msg, meta) => console.debug(prefix, msg, ...(meta ? [meta] : [])),
+        info: (msg, meta) => console.info(prefix, msg, ...(meta ? [meta] : [])),
+        warn: (msg, meta) => console.warn(prefix, msg, ...(meta ? [meta] : [])),
+        error: (msg, meta) => console.error(prefix, msg, ...(meta ? [meta] : [])),
+    };
+}
+function defaultSanitize(value) {
+    return value;
+}
+let createLoggerFn = defaultCreateLogger;
+let sanitizeFn = defaultSanitize;
+/**
+ * Override the logger factory used by all protocol-internal logging.
+ * Call this at application startup to wire in your project's logger.
+ *
+ * @example
+ * ```ts
+ * import { log, sanitizeForLog } from "./lib/log.js";
+ * import { setLoggerFactory } from "./lib/protocol/support/log.js";
+ *
+ * setLoggerFactory(
+ *   (context, source) => log.withContext(context as LogContext, source),
+ *   sanitizeForLog,
+ * );
+ * ```
+ */
+export function setLoggerFactory(factory, sanitize) {
+    createLoggerFn = factory;
+    if (sanitize)
+        sanitizeFn = sanitize;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// PUBLIC API
+// ═══════════════════════════════════════════════════════════════════════════════
+/** Sanitize an object for logging (redacts embeddings when host logger is wired in). */
+export function sanitizeForLog(value) {
+    return sanitizeFn(value);
+}
+function lazyContext(context) {
+    return {
+        from: (source) => createLoggerFn(context, source),
+    };
+}
+/**
+ * Logger with pre-bound context. Usage:
+ * ```ts
+ * const logger = log.protocol.from('MyComponent');
+ * logger.info('started');
+ * ```
+ *
+ * Logger creation is deferred to call time so `setLoggerFactory()` can be
+ * called at app startup and all subsequent `.from()` calls use the new factory.
+ */
+export const log = {
+    protocol: lazyContext('protocol'),
+    lib: lazyContext('lib'),
+    agent: lazyContext('agent'),
+    graph: lazyContext('graph'),
+};
+//# sourceMappingURL=log.js.map

package/dist/support/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/support/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,kFAAkF;AAClF,yBAAyB;AACzB,kFAAkF;AAElF,SAAS,mBAAmB,CAAC,QAAgB,EAAE,MAAc;IAC3D,MAAM,MAAM,GAAG,IAAI,MAAM,GAAG,CAAC;IAC7B,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3E,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AASD,IAAI,cAAc,GAAkB,mBAAmB,CAAC;AACxD,IAAI,UAAU,GAAe,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB,EAAE,QAAqB;IAC5E,cAAc,GAAG,OAAO,CAAC;IACzB,IAAI,QAAQ;QAAE,UAAU,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED,kFAAkF;AAClF,aAAa;AACb,kFAAkF;AAElF,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO;QACL,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC;IACjC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;CAC5B,CAAC"}

package/dist/support/lucide.icon-catalog.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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;
+//# sourceMappingURL=lucide.icon-catalog.d.ts.map

package/dist/support/lucide.icon-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucide.icon-catalog.d.ts","sourceRoot":"","sources":["../../src/support/lucide.icon-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAiE3C,CAAC;AAIX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAKzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAG9E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,SAAK,GAAG,MAAM,CAG3D"}

package/dist/support/lucide.icon-catalog.js

@@ -0,0 +1,101 @@
+/**
+ * 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(', ');
+}
+//# sourceMappingURL=lucide.icon-catalog.js.map

package/dist/support/lucide.icon-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucide.icon-catalog.js","sourceRoot":"","sources":["../../src/support/lucide.icon-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AAErD,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,WAAW;IACX,WAAW;IACX,OAAO;IACP,KAAK;IACL,MAAM;IACN,OAAO;IACP,gBAAgB;IAChB,UAAU;IACV,WAAW;IACX,QAAQ;IACR,KAAK;IACL,WAAW;IACX,SAAS;IACT,OAAO;IACP,OAAO;IACP,MAAM;IACN,aAAa;IACb,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,aAAa;IACb,OAAO;IACP,MAAM;IACN,MAAM;IACN,UAAU;IACV,OAAO;IACP,OAAO;IACP,MAAM;IACN,UAAU;IACV,MAAM;IACN,SAAS;IACT,WAAW;IACX,OAAO;IACP,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,MAAM;IACN,SAAS;IACT,UAAU;IACV,QAAQ;IACR,WAAW;IACX,WAAW;IACX,WAAW;IACX,UAAU;IACV,aAAa;IACb,eAAe;IACf,YAAY;IACZ,aAAa;IACb,WAAW;IACX,YAAY;IACZ,aAAa;IACb,MAAM;IACN,YAAY;IACZ,WAAW;IACX,MAAM;IACN,KAAK;IACL,SAAS;IACT,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,cAAc;CACN,CAAC;AAEX,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,uBAAuB,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA+B;IAC/D,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,yBAAyB,CAAC;IAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,UAAU;QAAE,OAAO,yBAAyB,CAAC;IAClD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA+B;IACpE,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAQ,GAAG,EAAE;IACjD,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/support/opportunity.card-text.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Viewer-centric text for opportunity cards.
+ * The card is shown to the viewer (logged-in user) and should introduce the
+ * counterpart, not describe the viewer to themselves.
+ */
+/**
+ * Returns viewer-centric main text for an opportunity card.
+ * Prefers the part of the reasoning that describes the counterpart (the person
+ * on the card), so the viewer sees an introduction to the counterpart rather
+ * than a description of themselves.
+ *
+ * @param reasoning - Raw interpretation.reasoning (may describe both parties).
+ * @param counterpartName - Display name of the suggested connection (e.g. "Alex Chen").
+ * @param maxChars - Max length of returned string (default MINIMAL_MAIN_TEXT_MAX_CHARS).
+ * @param viewerName - Optional display name of the viewer (signed-in user). When provided, sentences or prefixes describing the viewer are skipped so the card introduces the counterpart, not the viewer.
+ * @param introducerName - Optional display name of the introducer. When provided, introducer phrases (e.g., "X introduced you to...") are stripped from the summary to keep the body text focused on match quality.
+ * @returns Viewer-centric snippet mentioning the counterpart when possible; if counterpartName is empty, returns reasoning truncated to maxChars. Never null; may be "A suggested connection." when reasoning is empty.
+ */
+export declare function viewerCentricCardSummary(reasoning: string, counterpartName: string, maxChars?: number, viewerName?: string, introducerName?: string): string;
+/**
+ * Generates a short narrator remark from opportunity reasoning for the narrator chip.
+ * Used by the minimal (no-LLM) card path so each card gets a unique remark
+ * instead of the same static text.
+ *
+ * Extracts domain keywords (e.g. "AI", "design", "machine learning") from the
+ * reasoning and frames them in a short template like "Shared interest in AI and design."
+ *
+ * This is a regex-based heuristic — an alternative is OpportunityPresenter.presentHomeCard()
+ * which generates narratorRemark via LLM with much higher quality (already used by
+ * home.graph.ts and opportunity.discover.ts). See buildMinimalOpportunityCard() in
+ * opportunity.tools.ts for the trade-off discussion.
+ *
+ * @param reasoning - Raw interpretation.reasoning text.
+ * @param counterpartName - Display name of the counterpart (stripped from output).
+ * @param viewerName - Optional display name of the viewer (stripped from output).
+ * @returns A short remark (max ~80 chars) suitable for the narrator chip. Never truncated with "...".
+ */
+export declare function narratorRemarkFromReasoning(reasoning: string, counterpartName: string, viewerName?: string): string;
+//# sourceMappingURL=opportunity.card-text.d.ts.map

package/dist/support/opportunity.card-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.card-text.d.ts","sourceRoot":"","sources":["../../src/support/opportunity.card-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,QAAQ,GAAE,MAAoC,EAC9C,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAmGR;AAOD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAiDR"}

package/dist/support/opportunity.card-text.js

@@ -0,0 +1,333 @@
+/**
+ * Viewer-centric text for opportunity cards.
+ * The card is shown to the viewer (logged-in user) and should introduce the
+ * counterpart, not describe the viewer to themselves.
+ */
+import { MINIMAL_MAIN_TEXT_MAX_CHARS } from "./opportunity.constants.js";
+import { stripUuids, stripIntroducerMentions } from "./opportunity.sanitize.js";
+/**
+ * Splits text into sentences using (?<=[.!?])\s+ (period/exclamation/question followed by whitespace).
+ * Note: splits after any such punctuation, including abbreviations like "Dr." or "e.g.".
+ */
+function splitSentences(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    return trimmed
+        .split(/(?<=[.!?])\s+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Returns viewer-centric main text for an opportunity card.
+ * Prefers the part of the reasoning that describes the counterpart (the person
+ * on the card), so the viewer sees an introduction to the counterpart rather
+ * than a description of themselves.
+ *
+ * @param reasoning - Raw interpretation.reasoning (may describe both parties).
+ * @param counterpartName - Display name of the suggested connection (e.g. "Alex Chen").
+ * @param maxChars - Max length of returned string (default MINIMAL_MAIN_TEXT_MAX_CHARS).
+ * @param viewerName - Optional display name of the viewer (signed-in user). When provided, sentences or prefixes describing the viewer are skipped so the card introduces the counterpart, not the viewer.
+ * @param introducerName - Optional display name of the introducer. When provided, introducer phrases (e.g., "X introduced you to...") are stripped from the summary to keep the body text focused on match quality.
+ * @returns Viewer-centric snippet mentioning the counterpart when possible; if counterpartName is empty, returns reasoning truncated to maxChars. Never null; may be "A suggested connection." when reasoning is empty.
+ */
+export function viewerCentricCardSummary(reasoning, counterpartName, maxChars = MINIMAL_MAIN_TEXT_MAX_CHARS, viewerName, introducerName) {
+    const raw = stripUuids(reasoning);
+    if (!raw)
+        return "A suggested connection.";
+    const name = counterpartName.trim();
+    if (!name) {
+        let out = raw.length <= maxChars ? raw : raw.slice(0, maxChars) + "...";
+        // Strip introducer mentions BEFORE replacing viewer name to avoid "you introduced..." artifacts
+        if (introducerName) {
+            out = stripIntroducerMentions(out, introducerName);
+        }
+        out = replaceViewerNameWithYou(out, viewerName);
+        return out;
+    }
+    const sentences = splitSentences(raw);
+    const nameLower = name.toLowerCase();
+    const firstWordOfName = name.split(/\s+/)[0]?.toLowerCase();
+    const hasCounterpartName = (s) => s.toLowerCase().includes(nameLower) ||
+        (firstWordOfName && firstWordOfName.length > 1 && s.toLowerCase().includes(firstWordOfName));
+    const viewer = viewerName?.trim().toLowerCase();
+    const viewerFirstWord = viewerName?.trim().split(/\s+/)[0]?.toLowerCase();
+    const startsWithViewer = (s) => {
+        if (!viewer)
+            return false;
+        const sl = s.toLowerCase();
+        return sl.startsWith(viewer) ||
+            (viewerFirstWord && viewerFirstWord.length > 1 && sl.startsWith(viewerFirstWord));
+    };
+    // When viewerName is provided, prefer sentences that mention the counterpart
+    // but do NOT start with the viewer's name.
+    if (viewer) {
+        // First pass: find a sentence that mentions counterpart and doesn't start with viewer
+        const cleanIdx = sentences.findIndex((s) => hasCounterpartName(s) && !startsWithViewer(s));
+        if (cleanIdx !== -1) {
+            const result = sentences.slice(cleanIdx).join(" ").trim();
+            let out = result.length <= maxChars ? result : result.slice(0, maxChars) + "...";
+            // Strip introducer mentions BEFORE replacing viewer name to avoid "you introduced..." artifacts
+            if (introducerName) {
+                out = stripIntroducerMentions(out, introducerName);
+            }
+            out = replaceViewerNameWithYou(out, viewerName, [name]);
+            return out;
+        }
+        // Second pass: sentence mentions counterpart but starts with viewer (compound sentence).
+        // Try to extract the counterpart portion after the counterpart's name.
+        const compoundIdx = sentences.findIndex((s) => hasCounterpartName(s) && startsWithViewer(s));
+        if (compoundIdx !== -1) {
+            const sentence = sentences[compoundIdx];
+            // Find where the counterpart name appears and extract from there
+            // Use case-insensitive Unicode-aware regex so the index is correct
+            // even when toLowerCase() changes string length (e.g. Turkish İ→i, German ß→ss).
+            const cpMatch = sentence.match(new RegExp(escapeRegex(name), "iu"));
+            const cpIdx = cpMatch?.index ?? -1;
+            if (cpIdx > 0) {
+                const extracted = sentence.slice(cpIdx).trim();
+                const rest = sentences.slice(compoundIdx + 1).join(" ").trim();
+                const result = rest ? `${extracted} ${rest}` : extracted;
+                let out = result.length <= maxChars ? result : result.slice(0, maxChars) + "...";
+                // Strip introducer mentions BEFORE replacing viewer name to avoid "you introduced..." artifacts
+                if (introducerName) {
+                    out = stripIntroducerMentions(out, introducerName);
+                }
+                out = replaceViewerNameWithYou(out, viewerName, [name]);
+                return out;
+            }
+        }
+    }
+    // Fallback: original logic without viewer awareness
+    const idx = sentences.findIndex(hasCounterpartName);
+    if (idx === -1) {
+        let out = raw.length <= maxChars ? raw : raw.slice(0, maxChars) + "...";
+        // Strip introducer mentions BEFORE replacing viewer name to avoid "you introduced..." artifacts
+        if (introducerName) {
+            out = stripIntroducerMentions(out, introducerName);
+        }
+        out = replaceViewerNameWithYou(out, viewerName, [name]);
+        return out;
+    }
+    const fromCounterpart = sentences.slice(idx).join(" ").trim();
+    let out = fromCounterpart.length <= maxChars
+        ? fromCounterpart
+        : fromCounterpart.slice(0, maxChars) + "...";
+    // Strip introducer mentions BEFORE replacing viewer name to avoid "you introduced..." artifacts
+    if (introducerName) {
+        out = stripIntroducerMentions(out, introducerName);
+    }
+    out = replaceViewerNameWithYou(out, viewerName, [name]);
+    return out;
+}
+/** Max length for narrator chip text (matches LLM presenter schema). */
+const NARRATOR_MAX_CHARS = 80;
+const FALLBACK_REMARK = "A potential connection worth exploring.";
+/**
+ * Generates a short narrator remark from opportunity reasoning for the narrator chip.
+ * Used by the minimal (no-LLM) card path so each card gets a unique remark
+ * instead of the same static text.
+ *
+ * Extracts domain keywords (e.g. "AI", "design", "machine learning") from the
+ * reasoning and frames them in a short template like "Shared interest in AI and design."
+ *
+ * This is a regex-based heuristic — an alternative is OpportunityPresenter.presentHomeCard()
+ * which generates narratorRemark via LLM with much higher quality (already used by
+ * home.graph.ts and opportunity.discover.ts). See buildMinimalOpportunityCard() in
+ * opportunity.tools.ts for the trade-off discussion.
+ *
+ * @param reasoning - Raw interpretation.reasoning text.
+ * @param counterpartName - Display name of the counterpart (stripped from output).
+ * @param viewerName - Optional display name of the viewer (stripped from output).
+ * @returns A short remark (max ~80 chars) suitable for the narrator chip. Never truncated with "...".
+ */
+export function narratorRemarkFromReasoning(reasoning, counterpartName, viewerName) {
+    const raw = stripUuids(reasoning).trim();
+    if (!raw)
+        return FALLBACK_REMARK;
+    // Strip all person names from the text so we work only with topics.
+    let cleaned = raw;
+    for (const name of [counterpartName, viewerName]) {
+        if (!name?.trim())
+            continue;
+        const full = name.trim();
+        cleaned = cleaned.replace(new RegExp(escapeRegex(full), "gi"), "").trim();
+        const first = full.split(/\s+/)[0];
+        if (first && first.length > 1) {
+            cleaned = cleaned.replace(new RegExp(`\\b${escapeRegex(first)}\\b`, "gi"), "").trim();
+        }
+    }
+    // Extract domain/topic noun phrases from the cleaned text.
+    // Match multi-word capitalized phrases (e.g. "AI operations toolkit") and
+    // known domain terms.
+    const domainTerms = extractDomainTerms(cleaned);
+    if (domainTerms.length > 0) {
+        // Build "Shared interest in X and Y." or "Overlap in X, Y, and Z."
+        const prefixes = [
+            "Shared interest in",
+            "Overlap in",
+            "Common ground in",
+            "Aligned on",
+            "Mutual interest in",
+        ];
+        // Pick prefix deterministically based on first term's char code
+        const prefixIdx = domainTerms[0].charCodeAt(0) % prefixes.length;
+        const prefix = prefixes[prefixIdx];
+        const joined = joinTerms(domainTerms, NARRATOR_MAX_CHARS - prefix.length - 2); // -2 for " " and "."
+        const remark = `${prefix} ${joined}.`;
+        if (remark.length <= NARRATOR_MAX_CHARS)
+            return remark;
+    }
+    // Fallback: try to extract a short relationship phrase
+    const relationshipMatch = cleaned.match(/\b(complementary skills|shared expertise|overlapping intents|similar interests|strong match|mutual fit|potential collaboration|looking for (?:a |an )?[\w\s]{3,20})\b/i);
+    if (relationshipMatch) {
+        const phrase = relationshipMatch[0];
+        const remark = `Spotted ${phrase.toLowerCase()}.`;
+        if (remark.length <= NARRATOR_MAX_CHARS)
+            return remark;
+    }
+    return FALLBACK_REMARK;
+}
+/**
+ * Extracts domain/topic terms from text by matching known patterns:
+ * - Acronyms (AI, ML, UX, API)
+ * - Multi-word domain phrases (machine learning, game development)
+ * - Capitalized proper nouns that look like topics
+ */
+function extractDomainTerms(text) {
+    const seen = new Set();
+    const terms = [];
+    // Known domain phrases (order matters — longer first)
+    const knownPhrases = [
+        /\b(machine learning|artificial intelligence|software development|game development|web development|data science|deep learning|natural language processing|computer vision|cloud computing|mobile development|product design|user experience|graphic design|character design|frontend development|backend development|full[- ]stack|smart contracts|visual art|creative writing|content creation|digital marketing|venture capital|angel invest(?:ing|ment)|open source|blockchain|cryptocurrency|decentralized finance|social impact|community building|music production|film(?:making| production)|photography|illustration|animation|3D modeling|startup|co-?founding|entrepreneurship|research|consulting|mentoring|freelanc(?:e|ing))\b/gi,
+        /\b(AI|ML|UX|UI|API|NLP|SaaS|DeFi|DevOps|DeSci|NFT|DAO|React|Node|Python|TypeScript|JavaScript|Rust|Solidity|Go|Swift|Kotlin|Figma|Blender|Unity|Unreal)\b/g,
+    ];
+    for (const pattern of knownPhrases) {
+        for (const match of text.matchAll(pattern)) {
+            const term = match[1] ?? match[0];
+            const key = term.toLowerCase();
+            if (!seen.has(key)) {
+                seen.add(key);
+                // Preserve case for short acronyms/proper nouns; lowercase multi-word phrases
+                if (term.length <= 5 && /^[A-Z]/.test(term)) {
+                    terms.push(term); // Keep React, AI, ML, etc. as-is
+                }
+                else {
+                    terms.push(key);
+                }
+            }
+        }
+    }
+    // If no known phrases found, look for capitalized multi-word phrases
+    // that look like explicit topic references (e.g. "Visual Art", "Smart Contracts").
+    // Only accept capitalized words to avoid grabbing meta-language from evaluator reasoning
+    // (e.g. "discoverer", "explicitly", "states" which are about the matching process, not topics).
+    if (terms.length === 0) {
+        // Multi-word capitalized phrases first (e.g. "Visual Art", "Creative Writing")
+        const multiWordPattern = /\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)+)\b/g;
+        for (const match of text.matchAll(multiWordPattern)) {
+            const term = match[1];
+            const key = term.toLowerCase();
+            if (!seen.has(key)) {
+                seen.add(key);
+                terms.push(key);
+                if (terms.length >= 3)
+                    break;
+            }
+        }
+        // Single capitalized words as last resort (skip common sentence-starters and meta-words)
+        if (terms.length === 0) {
+            const skipCapitalized = new Set([
+                // Articles / conjunctions / prepositions (capitalized at sentence start)
+                "the", "and", "but", "for", "from", "with", "without", "between",
+                "into", "about", "after", "before", "over", "under", "through",
+                // Common sentence starters / pronouns / determiners
+                "both", "their", "they", "this", "that", "these", "those",
+                "here", "there", "would", "could", "should", "also", "very",
+                "one", "another", "other", "each", "some", "many", "most",
+                "such", "clear", "high", "good", "well", "just", "even",
+                // Generic matching/relationship language
+                "strong", "match", "based", "making", "looking", "seeking",
+                "connection", "relationship", "opportunity", "overlap",
+                "complementary", "potential", "interested", "collaborate",
+                // Evaluator meta-language (about the matching process, not topics)
+                "intent", "intents", "profile", "user", "users", "person",
+                "discoverer", "explicitly", "states", "expressed", "mentioned",
+                "indicates", "suggests", "demonstrates", "describes", "involves",
+                "inference", "preparatory", "sincerity", "evaluator", "classifier",
+                "semantic", "pragmatic", "verification", "reconciliation",
+                "assertive", "commissive", "directive", "illocutionary",
+                "felicity", "utterance", "detected", "analysis", "confirmed",
+                "genuine", "conditions", "determined",
+                // Discourse markers
+                "particularly", "specifically", "especially", "primarily",
+                "overall", "furthermore", "however", "therefore", "moreover",
+            ]);
+            const capWords = text.match(/\b[A-Z][a-z]{2,}\b/g) ?? [];
+            for (const w of capWords) {
+                const key = w.toLowerCase();
+                if (!skipCapitalized.has(key) && !seen.has(key)) {
+                    seen.add(key);
+                    terms.push(key);
+                    if (terms.length >= 3)
+                        break;
+                }
+            }
+        }
+    }
+    return terms.slice(0, 3); // Max 3 terms
+}
+/** Joins terms into "X, Y, and Z" form, dropping terms if too long. */
+function joinTerms(terms, maxLen) {
+    if (terms.length === 1)
+        return terms[0];
+    // Try all terms first
+    for (let count = terms.length; count >= 1; count--) {
+        const subset = terms.slice(0, count);
+        let joined;
+        if (subset.length === 1) {
+            joined = subset[0];
+        }
+        else if (subset.length === 2) {
+            joined = `${subset[0]} and ${subset[1]}`;
+        }
+        else {
+            joined = `${subset.slice(0, -1).join(", ")}, and ${subset[subset.length - 1]}`;
+        }
+        if (joined.length <= maxLen)
+            return joined;
+    }
+    return terms[0].slice(0, maxLen);
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Replaces viewer's name with "you"/"your" so the card addresses the viewer in second person.
+ * Applied to mainText when viewerName is provided.
+ * @param otherNames - Other actor names in the card; first-name replacement is
+ *   skipped when the viewer's first name matches any other actor's first name.
+ */
+function replaceViewerNameWithYou(text, viewerName, otherNames) {
+    if (!viewerName?.trim())
+        return text;
+    const full = viewerName.trim();
+    const first = full.split(/\s+/)[0];
+    let out = text;
+    // Possessive: "Yankı's" → "your", "Yankı Ekin Yüksel's" → "your"
+    out = out.replace(new RegExp(`\\b${escapeRegex(full)}'s\\b`, "gi"), "your");
+    const otherFirstNames = (otherNames ?? [])
+        .map(n => n.trim().split(/\s+/)[0]?.toLowerCase())
+        .filter(Boolean);
+    const firstNameCollides = first && otherFirstNames.includes(first.toLowerCase());
+    if (first && first.length > 1 && !firstNameCollides) {
+        out = out.replace(new RegExp(`\\b${escapeRegex(first)}'s\\b`, "gi"), "your");
+    }
+    // Standalone: full name then first name so we don't break "Yankı Ekin Yüksel"
+    out = out.replace(new RegExp(`\\b${escapeRegex(full)}\\b`, "gi"), "you");
+    if (first && first.length > 1 && !firstNameCollides) {
+        out = out.replace(new RegExp(`\\b${escapeRegex(first)}\\b`, "gi"), "you");
+    }
+    return out;
+}
+//# sourceMappingURL=opportunity.card-text.js.map