@indexnetwork/protocol 0.1.0

package/dist/agents/home.categorizer.js

@@ -0,0 +1,170 @@
+/**
+ * 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 { config } from 'dotenv';
+config({ path: '.env.development' });
+import { getIconNamesForPrompt, DEFAULT_HOME_SECTION_ICON } from '../support/lucide.icon-catalog.js';
+import { protocolLogger } from '../support/protocol.logger.js';
+import { Timed } from "../support/performance.js";
+import { createModel } from "./model.config.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';
+/**
+ * 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() {
+        const llm = createModel("homeCategorizer");
+        this.model = llm.withStructuredOutput(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 this.model.invoke([
+                new SystemMessage(systemPrompt),
+                new HumanMessage(userContent),
+            ]);
+            const parsed = categorizationSchema.safeParse(result);
+            if (!parsed.success) {
+                logger.warn('HomeCategorizer parse failed', { error: parsed.error });
+                return {
+                    sections: [
+                        {
+                            id: 'opportunities',
+                            title: 'OPPORTUNITIES',
+                            iconName: DEFAULT_HOME_SECTION_ICON,
+                            itemIndices: cards.map((c) => c.index),
+                        },
+                    ],
+                };
+            }
+            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),
+            }));
+            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 {
+                sections: [
+                    {
+                        id: 'opportunities',
+                        title: 'OPPORTUNITIES',
+                        iconName: DEFAULT_HOME_SECTION_ICON,
+                        itemIndices: cards.map((c) => c.index),
+                    },
+                ],
+            };
+        }
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Array]),
+    __metadata("design:returntype", Promise)
+], HomeCategorizerAgent.prototype, "categorize", null);
+//# sourceMappingURL=home.categorizer.js.map

package/dist/agents/home.categorizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.categorizer.js","sourceRoot":"","sources":["../../src/agents/home.categorizer.ts"],"names":[],"mappings":"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"}

package/dist/agents/hyde.generator.d.ts

@@ -0,0 +1,27 @@
+import type { HydeTargetCorpus } from './lens.inferrer.js';
+export interface HydeGeneratorOutput {
+    text: string;
+}
+export interface HydeGenerateInput {
+    /** Original intent or query text. */
+    sourceText: string;
+    /** Free-text lens label from LensInferrer (e.g. "crypto infra VC"). */
+    lens: string;
+    /** Which corpus voice to generate in. */
+    corpus: HydeTargetCorpus;
+}
+/**
+ * Generates hypothetical documents in a target corpus voice for semantic search.
+ * Uses free-text lens labels (from LensInferrer) instead of enum strategies.
+ */
+export declare class HydeGenerator {
+    private model;
+    /**
+     * Generate a hypothetical document for the given source text and lens.
+     *
+     * @param input - Source text, lens label, and target corpus
+     * @returns Generated hypothetical document text
+     */
+    generate(input: HydeGenerateInput): Promise<HydeGeneratorOutput>;
+}
+//# sourceMappingURL=hyde.generator.d.ts.map

package/dist/agents/hyde.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.generator.d.ts","sourceRoot":"","sources":["../../src/agents/hyde.generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAyB3D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAEV;IAEH;;;;;OAKG;IAEG,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoBvE"}

package/dist/agents/hyde.generator.js

@@ -0,0 +1,75 @@
+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);
+};
+/**
+ * HyDE Generator Agent: pure LLM agent for generating hypothetical documents
+ * in the target corpus voice. Uses free-text lens labels instead of enum strategies.
+ */
+import { HumanMessage, SystemMessage } from '@langchain/core/messages';
+import { z } from 'zod';
+import { HYDE_CORPUS_PROMPTS } from './hyde.strategies.js';
+import { Timed } from "../support/performance.js";
+import { protocolLogger } from '../support/protocol.logger.js';
+import { createModel } from "./model.config.js";
+const logger = protocolLogger("HydeGenerator");
+const SYSTEM_PROMPT = `You are a Hypothetical Document Generator for semantic search.
+
+Your task: Given a source statement (e.g. an intent or goal), write a short hypothetical document in the voice of the TARGET side—the kind of person or statement that would be an ideal match for that source.
+
+Rules:
+- Write in first person as the target.
+- Be concrete and specific so the text is good for vector similarity search.
+- Output only the hypothetical document text, no meta-commentary.
+- Keep length to a few sentences or one short paragraph.`;
+const responseFormat = z.object({
+    hypotheticalDocument: z
+        .string()
+        .describe('The hypothetical document text in the target voice, suitable for embedding and retrieval'),
+});
+const model = createModel("hydeGenerator");
+/**
+ * Generates hypothetical documents in a target corpus voice for semantic search.
+ * Uses free-text lens labels (from LensInferrer) instead of enum strategies.
+ */
+export class HydeGenerator {
+    constructor() {
+        this.model = model.withStructuredOutput(responseFormat, {
+            name: "hyde_generator",
+        });
+    }
+    /**
+     * Generate a hypothetical document for the given source text and lens.
+     *
+     * @param input - Source text, lens label, and target corpus
+     * @returns Generated hypothetical document text
+     */
+    async generate(input) {
+        const promptText = HYDE_CORPUS_PROMPTS[input.corpus](input.sourceText, input.lens);
+        const messages = [
+            new SystemMessage(SYSTEM_PROMPT),
+            new HumanMessage(promptText),
+        ];
+        const result = await this.model.invoke(messages);
+        const parsed = responseFormat.parse(result);
+        const text = parsed.hypotheticalDocument ?? '';
+        logger.verbose('Generated HyDE document', {
+            lens: input.lens,
+            corpus: input.corpus,
+            textLength: text.length,
+        });
+        return { text };
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HydeGenerator.prototype, "generate", null);
+//# sourceMappingURL=hyde.generator.js.map

package/dist/agents/hyde.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.generator.js","sourceRoot":"","sources":["../../src/agents/hyde.generator.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;AAE/C,MAAM,aAAa,GAAG;;;;;;;;yDAQmC,CAAC;AAE1D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAC,CAAC;AAEH,MAAM,KAAK,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAe3C;;;GAGG;AACH,MAAM,OAAO,aAAa;IAA1B;QACU,UAAK,GAAG,KAAK,CAAC,oBAAoB,CAAC,cAAc,EAAE;YACzD,IAAI,EAAE,gBAAgB;SACvB,CAAC,CAAC;IA6BL,CAAC;IA3BC;;;;;OAKG;IAEG,AAAN,KAAK,CAAC,QAAQ,CAAC,KAAwB;QACrC,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnF,MAAM,QAAQ,GAAG;YACf,IAAI,aAAa,CAAC,aAAa,CAAC;YAChC,IAAI,YAAY,CAAC,UAAU,CAAC;SAC7B,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC;QAE/C,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE;YACxC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,IAAI,CAAC,MAAM;SACxB,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;CACF;AApBO;IADL,KAAK,EAAE;;;;6CAoBP"}

package/dist/agents/hyde.strategies.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HyDE (Hypothetical Document Embeddings) type definitions.
+ *
+ * The system is now role-agnostic: instead of hardcoded strategy names
+ * (mirror, reciprocal, mentor, investor, collaborator, hiree), an LLM
+ * infers free-text "lenses" dynamically. This file re-exports the lens
+ * types and provides constants for the HyDE pipeline.
+ */
+export type { Lens, HydeTargetCorpus, LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';
+/** Default cache TTL for ephemeral HyDE documents (1 hour). */
+export declare const HYDE_DEFAULT_CACHE_TTL = 3600;
+/**
+ * Prompt templates for HyDE document generation.
+ * Keyed by target corpus — the lens label provides the semantic specificity.
+ */
+export declare const HYDE_CORPUS_PROMPTS: Record<'profiles' | 'intents', (sourceText: string, lens: string) => string>;
+//# sourceMappingURL=hyde.strategies.d.ts.map

package/dist/agents/hyde.strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.strategies.d.ts","sourceRoot":"","sources":["../../src/agents/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE1G,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAa5G,CAAC"}

package/dist/agents/hyde.strategies.js

@@ -0,0 +1,29 @@
+/**
+ * HyDE (Hypothetical Document Embeddings) type definitions.
+ *
+ * The system is now role-agnostic: instead of hardcoded strategy names
+ * (mirror, reciprocal, mentor, investor, collaborator, hiree), an LLM
+ * infers free-text "lenses" dynamically. This file re-exports the lens
+ * types and provides constants for the HyDE pipeline.
+ */
+/** Default cache TTL for ephemeral HyDE documents (1 hour). */
+export const HYDE_DEFAULT_CACHE_TTL = 3600;
+/**
+ * Prompt templates for HyDE document generation.
+ * Keyed by target corpus — the lens label provides the semantic specificity.
+ */
+export const HYDE_CORPUS_PROMPTS = {
+    profiles: (sourceText, lens) => `
+    Write a professional biography for someone who could fulfill this need: "${sourceText}".
+    Focus on the specific expertise, background, and role described by: ${lens}.
+
+    Write in first person. Include concrete skills, domain experience, and current professional focus that would make them a strong match.
+  `,
+    intents: (sourceText, lens) => `
+    Write a goal or aspiration statement for someone who is: ${lens}.
+    This person's needs would complement: "${sourceText}".
+
+    Write in first person as if stating their own goal.
+  `,
+};
+//# sourceMappingURL=hyde.strategies.js.map

package/dist/agents/hyde.strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.strategies.js","sourceRoot":"","sources":["../../src/agents/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiF;IAC/G,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+EAC6C,UAAU;0EACf,IAAI;;;GAG3E;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+DAC8B,IAAI;6CACtB,UAAU;;;GAGpD;CACF,CAAC"}

package/dist/agents/intent.clarifier.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+declare const clarificationSchema: z.ZodObject<{
+    needsClarification: z.ZodBoolean;
+    reason: z.ZodString;
+    suggestedDescription: z.ZodNullable<z.ZodString>;
+    clarificationMessage: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    needsClarification: boolean;
+    suggestedDescription: string | null;
+    clarificationMessage: string | null;
+}, {
+    reason: string;
+    needsClarification: boolean;
+    suggestedDescription: string | null;
+    clarificationMessage: string | null;
+}>;
+export type IntentClarifierOutput = z.infer<typeof clarificationSchema>;
+export declare class IntentClarifier {
+    private readonly model;
+    private readonly suggestionModel;
+    private readonly clarificationDraftModel;
+    constructor();
+    invoke(description: string, profileContext: string, activeIntentsContext: string): Promise<IntentClarifierOutput>;
+    private generateSuggestion;
+    private generateClarificationDraft;
+}
+export {};
+//# sourceMappingURL=intent.clarifier.d.ts.map

package/dist/agents/intent.clarifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.clarifier.d.ts","sourceRoot":"","sources":["../../src/agents/intent.clarifier.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;EAKvB,CAAC;AASH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA4CxE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA2B;;IAiBtD,MAAM,CACjB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,qBAAqB,CAAC;YA2CnB,kBAAkB;YA6BlB,0BAA0B;CAoCzC"}

package/dist/agents/intent.clarifier.js

@@ -0,0 +1,186 @@
+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 { protocolLogger } from "../support/protocol.logger.js";
+import { Timed } from "../support/performance.js";
+import { createModel } from "./model.config.js";
+const logger = protocolLogger("IntentClarifier");
+const clarificationSchema = z.object({
+    needsClarification: z.boolean(),
+    reason: z.string(),
+    suggestedDescription: z.string().nullable(),
+    clarificationMessage: z.string().nullable(),
+});
+const suggestionSchema = z.object({
+    suggestedDescription: z.string(),
+});
+const clarificationDraftSchema = z.object({
+    suggestedDescription: z.string(),
+    clarificationMessage: z.string(),
+});
+const systemPrompt = `
+You evaluate whether an intent is specific enough to persist without asking the user to confirm a refinement.
+
+Only set needsClarification=true when the intent is truly vague — e.g. a single generic phrase with no role, domain, location, or other concrete criteria (like "find a job", "I need help", "looking for something").
+
+Do NOT ask for clarification when the user has already given:
+- A role or type (e.g. "UX designer", "technical co-founder", "engineer")
+- A domain or industry (e.g. "in AI", "climate tech", "fintech")
+- A location or format (e.g. "remote", "Berlin", "full-time")
+- Any other concrete detail that makes the intent actionable
+
+Default to needsClarification=false when in doubt. Only clarify when the intent is so broad that persisting it as-is would be unhelpful (e.g. literally "a job" or "something" with no other signal).
+
+Rules when needsClarification=true:
+- User Profile is the primary source for suggestedDescription; Active Intents are secondary.
+- You MUST provide a concrete suggestedDescription and short clarificationMessage.
+- Do not include JSON in clarificationMessage.
+`;
+const suggestionPrompt = `
+You generate one concrete, specific intent rewrite.
+
+Rules:
+- Output only a concise intent sentence in suggestedDescription.
+- Use profile as primary source of personalization.
+- Use active intents as secondary context for consistency.
+- Keep user intent meaning, but make it actionable and specific.
+- Never return an empty suggestion.
+`;
+const clarificationDraftPrompt = `
+You draft a concise clarification response for a vague intent.
+
+Rules:
+- Return both:
+  1) suggestedDescription (specific rewritten intent)
+  2) clarificationMessage (single short message to the user)
+- clarificationMessage must include the suggestion naturally and ask for confirmation.
+- Use this shape: ` + "`Did you mean: \"<suggestedDescription>\"?`" + ` followed by a brief confirmation instruction.
+- Keep it short. No bullet lists. No JSON.
+`;
+export class IntentClarifier {
+    constructor() {
+        const baseModel = createModel("intentClarifier");
+        this.model = baseModel.withStructuredOutput(clarificationSchema, {
+            name: "intent_clarifier",
+        });
+        this.suggestionModel = baseModel.withStructuredOutput(suggestionSchema, {
+            name: "intent_clarifier_suggestion",
+        });
+        this.clarificationDraftModel = baseModel.withStructuredOutput(clarificationDraftSchema, { name: "intent_clarifier_message" });
+    }
+    async invoke(description, profileContext, activeIntentsContext) {
+        try {
+            const prompt = `
+# User Input Intent
+${description}
+
+# User Profile
+${profileContext || "none"}
+
+# Active Intents
+${activeIntentsContext || "none"}
+`;
+            const result = await this.model.invoke([
+                new SystemMessage(systemPrompt),
+                new HumanMessage(prompt),
+            ]);
+            const parsed = clarificationSchema.parse(result);
+            if (parsed.needsClarification) {
+                // Always prefer a dedicated rewrite pass for vague inputs so we avoid generic follow-up text.
+                const draft = await this.generateClarificationDraft(description, profileContext, activeIntentsContext);
+                if (draft) {
+                    return {
+                        ...parsed,
+                        suggestedDescription: draft.suggestedDescription,
+                        clarificationMessage: draft.clarificationMessage,
+                    };
+                }
+            }
+            return parsed;
+        }
+        catch (error) {
+            logger.warn("invoke: clarification failed", { error });
+            return {
+                needsClarification: false,
+                reason: "fallback_on_model_error",
+                suggestedDescription: null,
+                clarificationMessage: null,
+            };
+        }
+    }
+    async generateSuggestion(description, profileContext, activeIntentsContext) {
+        try {
+            const prompt = `
+# User Input Intent
+${description}
+
+# User Profile
+${profileContext || "none"}
+
+# Active Intents
+${activeIntentsContext || "none"}
+`;
+            const output = await this.suggestionModel.invoke([
+                new SystemMessage(suggestionPrompt),
+                new HumanMessage(prompt),
+            ]);
+            const parsed = suggestionSchema.parse(output);
+            const suggestion = parsed.suggestedDescription.trim();
+            return suggestion.length > 0 ? suggestion : null;
+        }
+        catch (error) {
+            logger.warn("generateSuggestion: failed", { error });
+            return null;
+        }
+    }
+    async generateClarificationDraft(description, profileContext, activeIntentsContext) {
+        try {
+            const prompt = `
+# User Input Intent
+${description}
+
+# User Profile
+${profileContext || "none"}
+
+# Active Intents
+${activeIntentsContext || "none"}
+`;
+            const output = await this.clarificationDraftModel.invoke([
+                new SystemMessage(clarificationDraftPrompt),
+                new HumanMessage(prompt),
+            ]);
+            const parsed = clarificationDraftSchema.parse(output);
+            const suggestedDescription = parsed.suggestedDescription.trim();
+            const clarificationMessage = parsed.clarificationMessage.trim();
+            if (!suggestedDescription || !clarificationMessage)
+                return null;
+            return { suggestedDescription, clarificationMessage };
+        }
+        catch (error) {
+            logger.warn("generateClarificationDraft: failed", { error });
+            const suggestion = await this.generateSuggestion(description, profileContext, activeIntentsContext);
+            if (!suggestion)
+                return null;
+            const clarificationMessage = `Do you mean: ${suggestion}?`;
+            return {
+                suggestedDescription: suggestion,
+                clarificationMessage,
+            };
+        }
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], IntentClarifier.prototype, "invoke", null);
+//# sourceMappingURL=intent.clarifier.js.map

package/dist/agents/intent.clarifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.clarifier.js","sourceRoot":"","sources":["../../src/agents/intent.clarifier.ts"],"names":[],"mappings":"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"}

package/dist/agents/intent.indexer.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+export declare const IntentIndexerOutputSchema: z.ZodObject<{
+    indexScore: z.ZodNumber;
+    memberScore: z.ZodNumber;
+    reasoning: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reasoning: string;
+    indexScore: number;
+    memberScore: number;
+}, {
+    reasoning: string;
+    indexScore: number;
+    memberScore: number;
+}>;
+/**
+ * Output structure for the Intent Indexer agent.
+ */
+export type IntentIndexerOutput = z.infer<typeof IntentIndexerOutputSchema>;
+export declare class IntentIndexer {
+    private model;
+    constructor();
+    /**
+     * Converts the structured response into a string for logging or embedding.
+     * Used when the output needs to be serialized (e.g. for traces).
+     */
+    private toString;
+    /**
+     * Main entry point. Evaluates the appropriateness of an intent for a given index and member context.
+     *
+     * @param intent - The intent payload.
+     * @param indexPrompt - The purpose of the index (community).
+     * @param memberPrompt - The member's sharing preferences (optional).
+     * @param sourceName - Optional source name for context (e.g. file, link).
+     * @returns Structured output with indexScore, memberScore, and reasoning, or null on error.
+     */
+    invoke(intent: string, indexPrompt: string | null, memberPrompt: string | null, sourceName?: string | null): Promise<IntentIndexerOutput | null>;
+    /**
+     * Alias for invoke. Evaluates the appropriateness of an intent for a given index and member context.
+     * Kept for compatibility with callers (e.g. Index Graph) that use evaluate().
+     */
+    evaluate(intent: string, indexPrompt: string | null, memberPrompt: string | null, sourceName?: string | null): Promise<IntentIndexerOutput | null>;
+    /**
+     * Factory method to expose the agent as a LangChain tool.
+     * Useful for composing agents into larger graphs.
+     */
+    static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        intent: z.ZodString;
+        indexPrompt: z.ZodNullable<z.ZodString>;
+        memberPrompt: z.ZodNullable<z.ZodString>;
+        sourceName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        intent: string;
+        indexPrompt: string | null;
+        memberPrompt: string | null;
+        sourceName?: string | null | undefined;
+    }, {
+        intent: string;
+        indexPrompt: string | null;
+        memberPrompt: string | null;
+        sourceName?: string | null | undefined;
+    }>, {
+        intent: string;
+        indexPrompt: string | null;
+        memberPrompt: string | null;
+        sourceName?: string | null | undefined;
+    }, {
+        intent: string;
+        indexPrompt: string | null;
+        memberPrompt: string | null;
+        sourceName?: string | null | undefined;
+    }, {
+        reasoning: string;
+        indexScore: number;
+        memberScore: number;
+    } | null, unknown, "intent_indexer">;
+}
+//# sourceMappingURL=intent.indexer.d.ts.map