@indexnetwork/protocol 0.1.0

package/dist/agents/profile.generator.js

@@ -0,0 +1,97 @@
+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 { tool } from "@langchain/core/tools";
+import { z } from "zod/v4";
+import { protocolLogger } from "../support/protocol.logger.js";
+import { config } from "dotenv";
+import { Timed } from "../support/performance.js";
+import { createModel } from "./model.config.js";
+config({ path: '.env.development', override: true });
+const logger = protocolLogger("ProfileGenerator");
+const model = createModel("profileGenerator");
+const systemPrompt = `
+    You are an expert profiler. Your task is to synthesize a structured User Profile from raw data or user requests.
+
+    When given EXISTING PROFILE + USER REQUEST: Apply the request to the existing profile. Add, update, or remove skills and interests as the user asks. Preserve everything else. Output the full updated profile.
+
+    When given raw data only: Infer name, bio, location, narrative.context, and extract skills and interests.
+
+    PRIVACY: identity.bio and narrative.context are public-facing. Never include email addresses, phone numbers, physical addresses, government IDs, or other contact identifiers — even if they appear in the raw data. Describe the person professionally; do not embed ways to contact them.
+`;
+const responseFormat = z.object({
+    identity: z.object({
+        name: z.string().describe("The user's full name"),
+        bio: z.string().describe("Professional summary (2-3 sentences) only; no email, phone, physical address, government ID, or other contact identifiers"),
+        location: z.string().describe("Inferred location (City, Country) or 'Remote'"),
+    }),
+    narrative: z.object({
+        context: z.string().describe("Rich narrative without email, phone, physical address, government ID, or other contact identifiers"),
+    }),
+    attributes: z.object({
+        interests: z.array(z.string()).describe("Inferred or explicit interests"),
+        skills: z.array(z.string()).describe("Professional skills"),
+    }),
+});
+export class ProfileGenerator {
+    constructor() {
+        this.model = model.withStructuredOutput(responseFormat, {
+            name: "profile_generator"
+        });
+    }
+    toString(profile) {
+        const textToEmbed = [
+            '# Identity',
+            '## Name', profile.identity.name,
+            '## Bio', profile.identity.bio,
+            '## Location', profile.identity.location,
+            '# Narrative',
+            '## Context', profile.narrative.context,
+            '# Attributes',
+            '## Interests', profile.attributes.interests.join(', '),
+            '## Skills', profile.attributes.skills.join(', ')
+        ].join('\n');
+        return textToEmbed;
+    }
+    async invoke(input) {
+        logger.verbose("Received input", { inputLength: input?.length });
+        const messages = [
+            new SystemMessage(systemPrompt),
+            new HumanMessage(`Here is the raw data:\n${input}`)
+        ];
+        const result = await this.model.invoke(messages);
+        const output = responseFormat.parse(result);
+        const textToEmbed = this.toString(output);
+        logger.verbose("Generated profile", {
+            skillsCount: output.attributes.skills.length,
+            interestsCount: output.attributes.interests.length
+        });
+        return { output, textToEmbed };
+    }
+    static asTool() {
+        return tool(async (args) => {
+            const profileGenerator = new ProfileGenerator();
+            return await profileGenerator.invoke(args.input);
+        }, {
+            name: 'profileGenerator',
+            description: 'Profile Generator',
+            schema: z.object({
+                input: z.string().describe('Raw data scraped from the web (via Parallel.ai)'),
+            })
+        });
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], ProfileGenerator.prototype, "invoke", null);
+//# sourceMappingURL=profile.generator.js.map

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

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

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

@@ -0,0 +1,43 @@
+import { z } from "zod/v4";
+export declare class HydeGenerator {
+    private model;
+    constructor();
+    private toString;
+    invoke(input: string): Promise<{
+        output: {
+            identity: {
+                bio: string;
+            };
+            narrative: {
+                context: string;
+            };
+            attributes: {
+                interests: string[];
+                skills: string[];
+            };
+        };
+        textToEmbed: string;
+    }>;
+    static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        input: z.ZodString;
+    }, z.core.$strip>, {
+        input: string;
+    }, {
+        input: string;
+    }, {
+        output: {
+            identity: {
+                bio: string;
+            };
+            narrative: {
+                context: string;
+            };
+            attributes: {
+                interests: string[];
+                skills: string[];
+            };
+        };
+        textToEmbed: string;
+    }, unknown, "hydeGenerator">;
+}
+//# sourceMappingURL=profile.hyde.generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.hyde.generator.d.ts","sourceRoot":"","sources":["../../src/agents/profile.hyde.generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AA0D3B,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAM;;IAOnB,OAAO,CAAC,QAAQ;IAeH,MAAM,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;WAgBnB,MAAM;;;;;;;;;;;;;;;;;;;;;CAerB"}

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

@@ -0,0 +1,113 @@
+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 { tool } from "@langchain/core/tools";
+import { z } from "zod/v4";
+import { protocolLogger } from "../support/protocol.logger.js";
+/**
+ * Config
+ */
+import { config } from "dotenv";
+config({ path: '.env.development', override: true });
+import { Timed } from "../support/performance.js";
+import { createModel } from "./model.config.js";
+const logger = protocolLogger("HyDEGenerator");
+const model = createModel("profileHydeGenerator");
+const systemPrompt = `
+    You are a Profile Profiler.
+    Given a user's profile, imagine a **Hypothetical User Profile** person that would be the best match for the user to accomplish their goals.
+    
+    Imagine this ideal candidate actually exists. Write a profile for THEM.
+    Your output will be used to vector-search a database of real user profiles.
+
+    Structure your response as a natural language Bio/Narrative written in the **Third Person**.
+    
+    The description should include:
+    1. **Context**: Who they are (role, background).
+    2. **Skills/lnterests**: What they are good at that complements the user.
+    3. **Goals**: What they are trying to achieve that aligns with the user.
+    
+    **CRITICAL INSTRUCTION - COMPLEMENTARY MATCHING:**
+    - Do NOT just look for "similar" people. Look for people who provide what the user NEEDS (Supply/Demand).
+    - If the user is a **Founder**, describe an **Investor** or **VC**.
+    - If the user is a **Learner**, describe a **Mentor** or **Expert**.
+    - If the user is a **Builder**, describe a **Collaborator** or **Co-founder**.
+    
+    Do NOT describe the Source User. Describe the TARGET Match.
+    Do NOT invent a name for the candidate. Refer to them as "The candidate", "They", or "This individual".
+    Do NOT include locations.
+
+    PRIVACY: Never include email addresses, phone numbers, physical addresses, government IDs, or other contact identifiers in bio or narrative — even if they appear in the source profile.
+`;
+const responseFormat = z.object({
+    identity: z.object({
+        bio: z.string().describe("Professional summary only; no email, phone, physical address, government ID, or other contact identifiers"),
+    }),
+    narrative: z.object({
+        context: z.string().describe("Rich narrative without email, phone, physical address, government ID, or other contact identifiers"),
+    }),
+    attributes: z.object({
+        interests: z.array(z.string()).describe("Inferred or explicit interests"),
+        skills: z.array(z.string()).describe("Professional skills"),
+    }),
+});
+export class HydeGenerator {
+    constructor() {
+        this.model = model.withStructuredOutput(responseFormat, {
+            name: "hyde_generator"
+        });
+    }
+    toString(description) {
+        const textToEmbed = [
+            '# Identity',
+            '## Bio', description.identity.bio,
+            '# Narrative',
+            '## Context', description.narrative.context,
+            '# Attributes',
+            '## Interests', description.attributes.interests.join(', '),
+            '## Skills', description.attributes.skills.join(', ')
+        ].join('\n');
+        return textToEmbed;
+    }
+    async invoke(input) {
+        logger.verbose("Received input", { inputLength: input?.length });
+        const messages = [
+            new SystemMessage(systemPrompt),
+            new HumanMessage(`Here is the profile for the HyDE Generation:\n${input}`)
+        ];
+        const result = await this.model.invoke(messages);
+        const output = responseFormat.parse(result);
+        const textToEmbed = this.toString(output);
+        logger.verbose("Generated HyDE profile", {
+            skillsCount: output.attributes.skills.length,
+            interestsCount: output.attributes.interests.length
+        });
+        return { output, textToEmbed };
+    }
+    static asTool() {
+        return tool(async (args) => {
+            const hydeGenerator = new HydeGenerator();
+            return await hydeGenerator.invoke(args.input);
+        }, {
+            name: 'hydeGenerator',
+            description: 'HyDE Generator',
+            schema: z.object({
+                input: z.string().describe('The profile to generate a HyDE for'),
+            })
+        });
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], HydeGenerator.prototype, "invoke", null);
+//# sourceMappingURL=profile.hyde.generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.hyde.generator.js","sourceRoot":"","sources":["../../src/agents/profile.hyde.generator.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;AAE/C,MAAM,KAAK,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAElD,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBpB,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2GAA2G,CAAC;KACtI,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;KACnI,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QACzE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;KAC5D,CAAC;CACH,CAAC,CAAC;AAKH,MAAM,OAAO,aAAa;IAExB;QACE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,oBAAoB,CAAC,cAAc,EAAE;YACtD,IAAI,EAAE,gBAAgB;SACvB,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ,CAAC,WAA4B;QAC3C,MAAM,WAAW,GAAG;YAClB,YAAY;YACZ,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG;YAClC,aAAa;YACb,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,OAAO;YAC3C,cAAc;YACd,cAAc,EAAE,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3D,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,WAAW,CAAC;IACrB,CAAC;IAGY,AAAN,KAAK,CAAC,MAAM,CAAC,KAAa;QAC/B,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG;YACf,IAAI,aAAa,CAAC,YAAY,CAAC;YAC/B,IAAI,YAAY,CAAC,iDAAiD,KAAK,EAAE,CAAC;SAC3E,CAAC;QACF,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,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE;YACvC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM;YAC5C,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM;SACnD,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAEM,MAAM,CAAC,MAAM;QAClB,OAAO,IAAI,CACT,KAAK,EAAE,IAAuB,EAAE,EAAE;YAChC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;YAC1C,OAAO,MAAM,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC,EACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,gBAAgB;YAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;aACjE,CAAC;SACH,CACF,CAAC;IACJ,CAAC;CACF;AA/Bc;IADZ,KAAK,EAAE;;;;2CAeP"}

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

@@ -0,0 +1,24 @@
+import type { ChatSuggestion } from "../types/chat-streaming.types.js";
+export interface SuggestionGeneratorInput {
+    /** Last few messages (user and assistant) to derive context */
+    messages: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    /** Optional index/community context to tailor suggestions */
+    indexContext?: string;
+}
+/**
+ * Lightweight generator for context-aware chat follow-up suggestions.
+ * Uses a fast model and structured output to return 3-5 suggestions per call.
+ */
+export declare class SuggestionGenerator {
+    private model;
+    constructor();
+    /**
+     * Generate follow-up suggestions from the last exchange.
+     * Returns empty array on failure (graceful degradation).
+     */
+    generate(input: SuggestionGeneratorInput): Promise<ChatSuggestion[]>;
+}
+//# sourceMappingURL=suggestion.generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.generator.d.ts","sourceRoot":"","sources":["../../src/agents/suggestion.generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAiCvE,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAiD;;IAO9D;;;OAGG;IAEG,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAsC3E"}

package/dist/agents/suggestion.generator.js

@@ -0,0 +1,96 @@
+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("SuggestionGenerator");
+const suggestionItemSchema = z.object({
+    label: z.string().describe("Short label for the chip (2-5 words)"),
+    type: z.enum(["direct", "prompt"]).describe("direct = auto-submit message; prompt = prefill input"),
+    followupText: z.string().nullable().describe("For type=direct: full message to send when clicked; null for prompt type"),
+    prefill: z.string().nullable().describe("For type=prompt: text to prefill the input; null for direct type"),
+});
+const suggestionsSchema = z.object({
+    suggestions: z
+        .array(suggestionItemSchema)
+        .min(1)
+        .max(6)
+        .describe("3-5 follow-up suggestions based on the conversation"),
+});
+const SYSTEM_PROMPT = `You generate follow-up suggestions for a chat user based on their conversation.
+
+Rules:
+- Return 3-5 suggestions. Mix of "direct" (one-click send) and "prompt" (prefill for user to edit).
+- Labels must be short: 2-5 words (e.g. "Find collaborators", "Add more details").
+- For type=direct: provide followupText as the exact message to send (complete sentence).
+- For type=prompt: provide prefill as the start of a sentence the user can complete (e.g. "I need help with ").
+- Suggestions must be relevant to the last exchange and natural next steps.
+- Do not repeat what the user or assistant just said; suggest logical follow-ups.
+- Voice: Calm, direct; no hype or networking clichés. Prefer words like opportunity, overlap, signal, pattern, relevant. Avoid: search, leverage, networking, match, optimize, scale.`;
+/**
+ * Lightweight generator for context-aware chat follow-up suggestions.
+ * Uses a fast model and structured output to return 3-5 suggestions per call.
+ */
+export class SuggestionGenerator {
+    constructor() {
+        const llm = createModel("suggestionGenerator");
+        this.model = llm.withStructuredOutput(suggestionsSchema, { name: "chat_suggestions" });
+    }
+    /**
+     * Generate follow-up suggestions from the last exchange.
+     * Returns empty array on failure (graceful degradation).
+     */
+    async generate(input) {
+        const { messages, indexContext } = input;
+        if (messages.length === 0)
+            return [];
+        const excerpt = messages
+            .slice(-6)
+            .map((m) => `${m.role === "user" ? "User" : "Assistant"}: ${m.content.slice(0, 300)}`)
+            .join("\n\n");
+        const userContent = indexContext
+            ? `Conversation (community context: ${indexContext}):\n\n${excerpt}\n\nGenerate 3-5 follow-up suggestions.`
+            : `Conversation:\n\n${excerpt}\n\nGenerate 3-5 follow-up suggestions.`;
+        try {
+            const result = await this.model.invoke([
+                new SystemMessage(SYSTEM_PROMPT),
+                new HumanMessage(userContent),
+            ]);
+            const parsed = suggestionsSchema.safeParse(result);
+            if (!parsed.success) {
+                logger.warn("[SuggestionGenerator] Parse failed", { error: parsed.error.message });
+                return [];
+            }
+            const out = parsed.data.suggestions.map((s) => ({
+                label: s.label,
+                type: s.type,
+                ...(s.type === "direct" && s.followupText != null && { followupText: s.followupText }),
+                ...(s.type === "prompt" && s.prefill != null && { prefill: s.prefill }),
+            }));
+            logger.verbose("[SuggestionGenerator] Generated", { count: out.length });
+            return out;
+        }
+        catch (error) {
+            logger.warn("[SuggestionGenerator] Failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SuggestionGenerator.prototype, "generate", null);
+//# sourceMappingURL=suggestion.generator.js.map

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

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