@indexnetwork/protocol 0.3.2 → 0.4.0-rc.12.1

package/dist/shared/agent/utility.tools.js

@@ -0,0 +1,276 @@
+import { z } from "zod";
+import { success, error, normalizeUrl } from "./tool.helpers.js";
+export function createUtilityTools(defineTool, deps) {
+    const { scraper } = deps;
+    const scrapeUrl = defineTool({
+        name: "scrape_url",
+        description: "Extracts text content from a web URL — articles, LinkedIn/GitHub profiles, documentation, project pages, etc. " +
+            "Returns the page's text content (up to 10,000 characters) for use in subsequent tool calls.\n\n" +
+            "**When to use:**\n" +
+            "- Before create_intent: when the user shares a URL and wants to create an intent from it. Scrape first, then synthesize into a description.\n" +
+            "- Before create_user_profile or update_user_profile: when the user shares a profile URL to update their profile from.\n" +
+            "- When the user asks about content at a URL.\n\n" +
+            "**URL format:** Bare domains work fine (e.g. 'github.com/user/repo') — protocol (https://) is added automatically.\n\n" +
+            "**Returns:** `{ url, contentLength, content }`. Content is truncated at 10,000 chars. " +
+            "Returns an error if the URL is unreachable, requires login, or has no extractable text.",
+        querySchema: z.object({
+            url: z.string().describe("The URL to extract content from. Protocol is optional — 'github.com/user/repo', 'linkedin.com/in/name', and 'https://example.com' all work."),
+            objective: z.string().optional().describe("Why you're scraping — guides content extraction for better results. Examples: 'User wants to create an intent from this project page', 'User wants to update their profile from this LinkedIn page', 'Extract key information about this company'. Omit for generic text extraction."),
+        }),
+        handler: async ({ context: _context, query }) => {
+            const normalizedUrl = normalizeUrl(query.url);
+            if (!normalizedUrl) {
+                return error("Invalid URL format. Please provide a valid URL (e.g. 'github.com/user/repo' or 'https://example.com').");
+            }
+            const content = await scraper.extractUrlContent(normalizedUrl, {
+                objective: query.objective?.trim() || undefined,
+            });
+            if (!content) {
+                return error("Couldn't extract content from that URL. It may be blocked, require login, or have no extractable text.");
+            }
+            const truncatedContent = content.length > 10000
+                ? content.substring(0, 10000) + "\n\n[Content truncated...]"
+                : content;
+            return success({
+                url: normalizedUrl,
+                contentLength: content.length,
+                content: truncatedContent,
+            });
+        },
+    });
+    const readDocs = defineTool({
+        name: "read_docs",
+        description: "Returns comprehensive documentation about the Index Network protocol — entity model, workflows, tool usage guidance, and domain concepts. " +
+            "This is the primary way for an external agent to bootstrap understanding of the system.\n\n" +
+            "**When to use:** Call this FIRST when starting a new session. MCP agents MUST call read_docs(topic='mcp_agent_guide') at the start of every conversation to learn proper output formatting and workflow rules.\n" +
+            "Also call when you need to understand:\n" +
+            "- What entities exist and how they relate (intents, indexes, opportunities, profiles, contacts)\n" +
+            "- The discovery workflow (how intents become opportunities)\n" +
+            "- Which tools to call in what order for common tasks\n" +
+            "- Authentication and API patterns\n\n" +
+            "**Returns:** Markdown documentation. Pass `topic` to get a specific section, or omit for the full reference.\n\n" +
+            "**Available topics:** 'entities', 'intents', 'opportunities', 'indexes', 'profiles', 'contacts', 'discovery', 'workflows', 'authentication', 'mcp_agent_guide'",
+        querySchema: z.object({
+            topic: z.string().optional().describe("Narrow to a specific topic: 'entities', 'intents', 'opportunities', 'indexes', 'profiles', 'contacts', 'discovery', 'workflows', or 'authentication'. Omit to get the full documentation."),
+        }),
+        handler: async ({ context: _context, query }) => {
+            const topic = query.topic?.trim().toLowerCase();
+            const sections = {
+                entities: `## Entity Model & Relationships
+
+- **Users**: People on the platform. Authenticated via API key (X-API-Key header) for MCP/external agents, or session-based (Better Auth) for the web app.
+- **Profiles**: A user's identity — name, bio, skills, interests, location, social links. Generated from account data or social URLs via enrichment. Has a vector embedding for semantic matching. One profile per user.
+- **Indexes** (also called "networks"): Communities or groups where members share intents and discover opportunities. Each has a title, optional prompt (purpose description), join policy (anyone or invite_only), and an owner. The user's **personal index** (isPersonal=true) stores their contacts.
+- **Index Members**: Junction between Users and Indexes. Tracks permissions (owner, member, contact), join date, auto-assign setting, and optional member prompt.
+- **Intents**: Signals of interest/need — what a user is looking for (e.g. "Looking for a React developer in Berlin"). Each has a description (payload), summary, confidence score (0-1), inferenceType (explicit/implicit), source tracking, and vector embedding.
+- **IntentNetworks**: Many-to-many junction between Intents and Indexes. An intent can be in multiple indexes. Has a relevancyScore (0-1) indicating how well the intent fits the index's purpose.
+- **Opportunities**: Discovered connections between users based on complementary intents within shared indexes. Have actors with roles (introducer, party), status lifecycle, match reasoning, confidence score, and presentation data.
+- **Contacts**: People in a user's personal network, stored as index members with 'contact' permission on the personal index. Can be real users or ghost users (placeholder accounts enriched from public data).
+- **Ghost Users**: Placeholder accounts created for contacts who aren't on the platform yet. Enriched with public profile data (LinkedIn, GitHub) and participate in opportunity matching.
+
+### Key Relationships
+- Users → Profiles (1:1)
+- Users → Indexes (many:many via Index Members)
+- Users → Intents (1:many, user owns intents)
+- Intents → Indexes (many:many via IntentNetworks with relevancyScore)
+- Opportunities → Users (many:many via actors with roles)
+- Opportunities → Indexes (scoped to shared index context)
+- Contacts → Personal Index (stored as members with 'contact' permission)`,
+                intents: `## Intent Lifecycle
+
+Intents are the core unit of discovery — they represent what users are seeking and drive semantic matching.
+
+1. **Creation** (create_intent): User describes what they're looking for. The system runs inference (extracting structured intents from free text) and verification (checking specificity, speech-act type). Returns a proposal for user approval.
+2. **Confidence & Classification**: Each intent gets a confidence score (0-1), inferenceType (explicit = user stated directly, implicit = system inferred), and speech act classification (commissive, directive, assertive).
+3. **Index Assignment**: After creation, the intent is automatically evaluated against all indexes the user belongs to. The index's prompt is used as criteria. Matching indexes get linked via IntentNetworks with a relevancyScore (0-1).
+4. **Discovery Trigger**: Creating an intent triggers background opportunity detection — the system searches for other users in shared indexes whose intents complement this one.
+5. **Source Tracking**: Intents track their origin via sourceType (file, integration, link, discovery_form, enrichment) and sourceId.
+6. **Update** (update_intent): Re-processes through inference/verification, recalculates embeddings and index assignments.
+7. **Archive** (delete_intent): Soft-deletes the intent. It stops participating in discovery but is not permanently removed.
+
+### Intent Best Practices
+- Be specific: "Looking for a senior React developer for a 3-month contract in Berlin" > "Need a developer"
+- One intent per need: don't combine multiple requests into one intent
+- Update rather than delete+create to preserve history`,
+                opportunities: `## Opportunity Lifecycle
+
+Opportunities represent discovered connections between users — potential matches worth pursuing.
+
+1. **Detection** (create_opportunities): The opportunity graph finds users whose intents semantically complement each other within shared indexes. Uses HyDE embeddings for retrieval and an LLM evaluator for scoring.
+2. **Roles**: Each opportunity assigns roles to actors:
+   - **introducer**: The person who triggered the introduction (may be the system or another user)
+   - **party**: The people being connected (typically 2)
+3. **Status Flow**: draft → pending → accepted/rejected/expired
+   - **draft**: Created but not sent. Only the creator/introducer sees it.
+   - **pending**: Sent to the other party. They're notified and can respond.
+   - **accepted**: Both parties agreed to connect.
+   - **rejected**: One party declined.
+   - **expired**: Timed out without response.
+4. **Creation Modes**:
+   - **Discovery**: Automatic — system finds matches based on intent overlap (create_opportunities with searchQuery)
+   - **Introduction**: Manual — a user introduces two specific people (create_opportunities with partyUserIds + entities)
+   - **Direct**: One-to-one — connect with a specific person (create_opportunities with targetUserId)
+5. **Presentation**: Each opportunity includes personalized match reasoning, confidence score, and suggested next action.
+
+### Opportunity Workflow
+1. create_opportunities(searchQuery="AI engineers") → returns draft opportunity cards
+2. update_opportunity(opportunityId, status="pending") → sends to other party
+3. Other party sees opportunity → calls update_opportunity(status="accepted" or "rejected")`,
+                indexes: `## Index Mechanics
+
+Indexes (also called "networks") are communities where members share what they're looking for and the system discovers connections between them.
+
+- **Purpose prompt**: Each index has an optional prompt describing its purpose (e.g. "AI/ML co-founders in Berlin"). This prompt is used by the intent indexer to evaluate whether an intent belongs in this community. Indexes without prompts accept all intents (relevancyScore defaults to 1.0).
+- **Join policy**: "anyone" (open — any user can self-join) or "invite_only" (only the owner can add members).
+- **Personal index**: Each user has exactly one personal index (isPersonal=true) created on registration. It stores their contacts. Cannot be deleted, renamed, or listed publicly.
+- **Membership**: Members can see all intents in the index. The **auto-assign** setting on a membership means new intents by that user are automatically evaluated against the index.
+- **Owner permissions**: Index owners can update settings (title, prompt, joinPolicy), add/remove members, and delete the index (if sole member).
+- **Discovery scope**: Opportunities are discovered within index boundaries — the system matches intents of members who share at least one index.
+
+### Index Workflow
+1. create_network(title, prompt) → creates new community, you become owner
+2. create_network_membership(networkId, userId) → invite members
+3. Members create intents → auto-assigned to the index based on prompt
+4. create_opportunities(networkId) → discover matches within this community`,
+                profiles: `## Profile System
+
+Profiles are the user's identity on the platform, used for semantic matching in opportunity discovery.
+
+- **Structure**: name, bio, location, skills[], interests[], social links (LinkedIn, GitHub, Twitter, websites)
+- **Generation**: Auto-generated from account data (name, email, social links) via web enrichment. Can also be created from explicit user input (bioOrDescription).
+- **Enrichment**: The system scrapes public profiles (LinkedIn, GitHub, Twitter) to build a rich identity with skills, interests, and narrative context.
+- **Embeddings**: Profiles have vector embeddings for semantic matching. HyDE (Hypothetical Document Embedding) generates synthetic documents:
+  - Mirror: self-description of the person
+  - Reciprocal: what this person would look for in others
+  - Neighborhood: related community context
+- **Onboarding flow**: create_user_profile() → preview → create_user_profile(confirm=true) → complete_onboarding()
+- **Updates**: Use update_user_profile for targeted changes, create_user_profile for full regeneration.
+
+### Profile Best Practices
+- Richer profiles produce better opportunity matches
+- Social links enable enrichment — encourage users to add LinkedIn/GitHub
+- Profiles are recalculated when updated, which may surface new matches`,
+                contacts: `## Contact Management
+
+Contacts are people in a user's personal network, stored as members of their personal index with 'contact' permission.
+
+- **Adding contacts**: Via import_contacts (bulk), add_contact (single email), or import_gmail_contacts (Google integration).
+- **Ghost users**: When a contact email doesn't match an existing account, a ghost user is created. Ghost users are enriched with public profile data and participate in opportunity matching — they can be discovered even before joining the platform.
+- **Personal index scope**: Pass the personal index networkId to create_opportunities to scope discovery to just the user's contacts.
+- **Contact data**: Each contact has userId, name, email, avatar, and isGhost flag.
+
+### Contact Workflow
+1. import_contacts or import_gmail_contacts → bulk add to network
+2. list_contacts → view all contacts with userId
+3. create_opportunities(networkId=personalIndexId) → find matches among contacts
+4. add_contact(email) → add individual contact
+5. remove_contact(contactUserId) → remove from network`,
+                discovery: `## Discovery Mechanics
+
+Discovery is the process of finding meaningful connections between users based on their intents and profiles.
+
+### How Discovery Works
+1. **Trigger**: Runs automatically when an intent is created, or explicitly when create_opportunities is called.
+2. **Pipeline**: Preparation (gather user context) → Scope (determine which indexes to search) → Candidate retrieval (semantic matching via HyDE embeddings) → Evaluation (LLM scores relevance and complementarity) → Ranking → Persist as opportunities.
+3. **Semantic matching**: Uses HyDE (Hypothetical Document Embeddings) to find candidate intents that complement the source. This goes beyond keyword matching — it understands conceptual relationships.
+4. **Evaluation**: An LLM evaluator agent scores each candidate match on relevance, complementarity, and actionability. Low-scoring matches are filtered out.
+5. **Results**: Persisted as draft opportunities with roles, reasoning, and confidence scores.
+6. **Background processing**: After intent creation, a queue job continues looking for matches asynchronously.
+7. **Pagination**: Large result sets are paginated. Use continueFrom with the discoveryId to evaluate more candidates.
+
+### Discovery Best Practices
+- More specific intents produce more relevant matches
+- Richer profiles improve matching quality
+- Scope to a specific index (networkId) for more targeted results
+- After discovery returns no results, suggest creating an intent to attract future matches`,
+                workflows: `## Common Tool Workflows
+
+### New User Setup
+1. create_user_profile(linkedinUrl/githubUrl) → generate profile from social data
+2. complete_onboarding() → unlock full access
+3. read_networks() → see available communities
+4. create_network_membership(networkId) → join a community
+5. create_intent(description) → post what you're looking for
+6. create_opportunities(searchQuery) → find matches
+
+### Finding Connections
+1. read_networks() → list user's communities (get networkId)
+2. create_opportunities(searchQuery, networkId) → discover matches
+3. Review opportunity cards → update_opportunity(opportunityId, status="pending") to send
+
+### Making an Introduction
+1. read_network_memberships(networkId) → find members in shared community
+2. read_user_profiles(userId) → get profiles of both parties
+3. read_intents(networkId, userId) → get intents of both parties
+4. create_opportunities(partyUserIds=[id1,id2], entities=[...], hint="reason") → create introduction
+
+### Managing Contacts
+1. import_gmail_contacts() or import_contacts([...]) → add contacts
+2. list_contacts() → view network
+3. create_opportunities(networkId=personalIndexId) → find matches among contacts
+
+### Creating a Community
+1. create_network(title, prompt) → create index
+2. create_network_membership(networkId, userId) → invite members
+3. Members create intents → auto-indexed
+4. create_opportunities(networkId) → discover connections within community`,
+                authentication: `## Authentication & API Access
+
+### For External AI Agents (MCP)
+- Authenticate via **X-API-Key** header with a valid API key
+- The API key is tied to a specific user account
+- All operations execute in the context of the authenticated user
+- Base URL: protocol.index.network/mcp
+
+### Key Constraints
+- Users can only read their own intents globally, or intents in indexes they belong to
+- Users can only read profiles of people in shared indexes
+- Index-scoped operations are restricted to that index
+- Personal indexes cannot be deleted or renamed
+- Only index owners can update settings, add/remove members (for invite_only indexes)
+
+### Rate Limits & Best Practices
+- Avoid unnecessary read_intents/read_networks calls — cache results within a conversation
+- Use pagination (limit/page) for large result sets
+- Call read_docs once at the start to understand the domain`,
+                mcp_agent_guide: `## MCP Agent Integration Guide
+
+**IMPORTANT: Read this section if you are an AI agent accessing Index Network via MCP tools.**
+
+### Output Formatting
+- Tool results often contain structured JSON data (proposals, opportunities, cards). **Do NOT dump raw JSON to the user.** Parse the JSON and present information in natural language with clear formatting.
+- Some tool results contain interactive card markup (code blocks with \`intent_proposal\`, \`opportunity_card\` language tags). These are designed for the Index Network web UI. **As an MCP agent, ignore card markup.** Instead, extract the meaningful data from the JSON and present it conversationally.
+- When presenting opportunities or intents, use bullet points or short paragraphs — not raw JSON objects.
+
+### Intent Creation Workflow
+- **Always pass \`autoApprove: true\` when calling \`create_intent\`.** This persists intents directly without returning proposal cards that require manual UI approval.
+- The tool will return a list of created intents with their descriptions and confidence scores. Present these in natural language.
+- Do not tell the user to "click on cards" or "approve above" — there is no UI. Intents are created immediately with autoApprove.
+- After creating intents, proactively suggest or run discovery to find matches.
+
+### Discovery Workflow
+- After creating intents, proactively suggest running discovery: \`create_opportunities(searchQuery=...)\`
+- Present discovered opportunities in natural language with the counterpart's name, match reasoning, and suggested next steps.
+- Do not reference "cards", "panels", or any web UI elements.
+
+### General MCP Agent Rules
+- You are operating via API tools, not a web interface. Never reference clicking, scrolling, cards, panels, or any visual UI elements.
+- Be proactive: if a logical next step exists (e.g., running discovery after creating intents), suggest or execute it.
+- Use \`list_opportunities\` to check existing matches, \`list_negotiations\` for ongoing negotiations.
+- Use \`read_networks\` to understand which communities the user belongs to before scoping operations.
+- When errors occur, provide clear technical context rather than vague "backend issue" messages.`,
+            };
+            if (topic) {
+                const matched = Object.entries(sections).find(([key]) => key.includes(topic) || topic.includes(key));
+                if (matched) {
+                    return success({ topic: matched[0], content: matched[1] });
+                }
+                // If topic not found, return all
+            }
+            const fullDoc = Object.values(sections).join("\n\n");
+            return success({ content: fullDoc });
+        },
+    });
+    return [scrapeUrl, readDocs];
+}
+//# sourceMappingURL=utility.tools.js.map

package/dist/shared/agent/utility.tools.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.generator.d.ts","sourceRoot":"","sources":["../../../src/shared/hyde/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 → shared/hyde}/hyde.generator.js

@@ -14,9 +14,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 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";
+import { Timed } from "../observability/performance.js";
+import { protocolLogger } from '../observability/protocol.logger.js';
+import { createModel } from "../agent/model.config.js";
 const logger = protocolLogger("HydeGenerator");
 const SYSTEM_PROMPT = `You are a Hypothetical Document Generator for semantic search.
 

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.generator.js","sourceRoot":"","sources":["../../../src/shared/hyde/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,iCAAiC,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,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/{graphs → shared/hyde}/hyde.graph.d.ts

@@ -4,13 +4,13 @@
  * Flow: infer_lenses → check_cache → (generate_missing if needed) → embed → cache_results.
  * Constructor injects Database, Embedder, Cache, LensInferrer, HydeGenerator.
  */
-import { type HydeDocumentState } from '../states/hyde.state.js';
-import { LensInferrer } from '../agents/lens.inferrer.js';
-import { HydeGenerator } from '../agents/hyde.generator.js';
+import { type HydeDocumentState } from './hyde.state.js';
+import { LensInferrer } from './lens.inferrer.js';
+import { HydeGenerator } from './hyde.generator.js';
 import type { HydeGraphDatabase } from '../interfaces/database.interface.js';
 import type { EmbeddingGenerator } from '../interfaces/embedder.interface.js';
 import type { HydeCache } from '../interfaces/cache.interface.js';
-import type { DebugMetaAgent } from '../types/chat-streaming.types.js';
+import type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';
 /**
  * Factory for the HyDE generation graph.
  * Injects Database, Embedder, Cache, LensInferrer, and HydeGenerator.
@@ -29,7 +29,7 @@ export declare class HydeGraphFactory {
         profileContext: string | undefined;
         maxLenses: number;
         forceRegenerate: boolean;
-        lenses: import("../agents/lens.inferrer.js").Lens[];
+        lenses: import("./lens.inferrer.js").Lens[];
         hydeDocuments: Record<string, HydeDocumentState>;
         hydeEmbeddings: Record<string, number[]>;
         error: string | undefined;
@@ -41,7 +41,7 @@ export declare class HydeGraphFactory {
         profileContext?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         maxLenses?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
         forceRegenerate?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
-        lenses?: import("../agents/lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("../agents/lens.inferrer.js").Lens[]> | undefined;
+        lenses?: import("./lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("./lens.inferrer.js").Lens[]> | undefined;
         hydeDocuments?: Record<string, HydeDocumentState> | import("@langchain/langgraph").OverwriteValue<Record<string, HydeDocumentState>> | undefined;
         hydeEmbeddings?: Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>> | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
@@ -61,7 +61,7 @@ export declare class HydeGraphFactory {
         profileContext: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         maxLenses: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
         forceRegenerate: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
-        lenses: import("@langchain/langgraph").BaseChannel<import("../agents/lens.inferrer.js").Lens[], import("../agents/lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("../agents/lens.inferrer.js").Lens[]>, unknown>;
+        lenses: import("@langchain/langgraph").BaseChannel<import("./lens.inferrer.js").Lens[], import("./lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("./lens.inferrer.js").Lens[]>, unknown>;
         hydeDocuments: import("@langchain/langgraph").BaseChannel<Record<string, HydeDocumentState>, Record<string, HydeDocumentState> | import("@langchain/langgraph").OverwriteValue<Record<string, HydeDocumentState>>, unknown>;
         hydeEmbeddings: import("@langchain/langgraph").BaseChannel<Record<string, number[]>, Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>>, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
@@ -81,14 +81,14 @@ export declare class HydeGraphFactory {
         profileContext: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         maxLenses: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
         forceRegenerate: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
-        lenses: import("@langchain/langgraph").BaseChannel<import("../agents/lens.inferrer.js").Lens[], import("../agents/lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("../agents/lens.inferrer.js").Lens[]>, unknown>;
+        lenses: import("@langchain/langgraph").BaseChannel<import("./lens.inferrer.js").Lens[], import("./lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("./lens.inferrer.js").Lens[]>, unknown>;
         hydeDocuments: import("@langchain/langgraph").BaseChannel<Record<string, HydeDocumentState>, Record<string, HydeDocumentState> | import("@langchain/langgraph").OverwriteValue<Record<string, HydeDocumentState>>, unknown>;
         hydeEmbeddings: import("@langchain/langgraph").BaseChannel<Record<string, number[]>, Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>>, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
     }, import("@langchain/langgraph").StateDefinition, {
         infer_lenses: {
-            lenses: import("../agents/lens.inferrer.js").Lens[];
+            lenses: import("./lens.inferrer.js").Lens[];
             agentTimings: DebugMetaAgent[];
         };
         check_cache: {

package/dist/shared/hyde/hyde.graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.graph.d.ts","sourceRoot":"","sources":["../../../src/shared/hyde/hyde.graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAKlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAyBzE;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;gBAJT,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,aAAa;IAGlC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoOZ"}

package/dist/{graphs → shared/hyde}/hyde.graph.js

@@ -6,11 +6,11 @@
  */
 import { StateGraph, START, END } from '@langchain/langgraph';
 import { createHash } from 'crypto';
-import { HydeGraphState } from '../states/hyde.state.js';
-import { HYDE_DEFAULT_CACHE_TTL } from '../agents/hyde.strategies.js';
-import { protocolLogger } from '../support/protocol.logger.js';
-import { timed } from '../support/performance.js';
-import { requestContext } from "../support/request-context.js";
+import { HydeGraphState } from './hyde.state.js';
+import { HYDE_DEFAULT_CACHE_TTL } from './hyde.strategies.js';
+import { protocolLogger } from '../observability/protocol.logger.js';
+import { timed } from '../observability/performance.js';
+import { requestContext } from "../observability/request-context.js";
 const logger = protocolLogger("HyDEGraphFactory");
 /** Hash a lens label (+ optional corpus) to a short key for cache/DB indexing. */
 function lensHash(label, corpus) {

package/dist/shared/hyde/hyde.graph.js.map

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

package/dist/{states → shared/hyde}/hyde.state.d.ts

@@ -3,8 +3,8 @@
  * Used by the HyDE graph for infer_lenses → check_cache → generate_missing → embed → cache_results.
  */
 import type { Id } from '../interfaces/database.interface.js';
-import type { Lens, HydeTargetCorpus } from '../agents/lens.inferrer.js';
-import type { DebugMetaAgent } from '../types/chat-streaming.types.js';
+import type { Lens, HydeTargetCorpus } from './lens.inferrer.js';
+import type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';
 /** Single HyDE document (text + embedding) for one lens. */
 export interface HydeDocumentState {
     lens: string;

package/dist/shared/hyde/hyde.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.state.d.ts","sourceRoot":"","sources":["../../../src/shared/hyde/hyde.state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,2CAA2C;AAC3C,eAAO,MAAM,cAAc;IAGzB,qDAAqD;;;;;;IAGrD,4EAA4E;;IAM5E,qFAAqF;;;;;;IAGrF,4EAA4E;;IAM5E,qDAAqD;;IAMrD,0DAA0D;;IAQ1D,mDAAmD;;IAMnD;;;OAGG;;IAMH;;;OAGG;;IAMH,+BAA+B;;IAM/B,sEAAsE;;EAKtE,CAAC"}

package/dist/shared/hyde/hyde.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.state.js","sourceRoot":"","sources":["../../../src/shared/hyde/hyde.state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAalD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAC5C,2EAA2E;IAE3E,qDAAqD;IACrD,UAAU,EAAE,CAAA,UAA0C,CAAA;IAEtD,4EAA4E;IAC5E,QAAQ,EAAE,UAAU,CAA0C;QAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,qFAAqF;IACrF,UAAU,EAAE,CAAA,UAAkB,CAAA;IAE9B,4EAA4E;IAC5E,cAAc,EAAE,UAAU,CAAqB;QAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,qDAAqD;IACrD,SAAS,EAAE,UAAU,CAAS;QAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;KACjB,CAAC;IAEF,0DAA0D;IAC1D,eAAe,EAAE,UAAU,CAAU;QACnC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;KACrB,CAAC;IAEF,0EAA0E;IAE1E,mDAAmD;IACnD,MAAM,EAAE,UAAU,CAAS;QACzB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;IAEF;;;OAGG;IACH,aAAa,EAAE,UAAU,CAAoC;QAC3D,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,cAAc,EAAE,UAAU,CAA2B;QACnD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB,CAAC;IAEF,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAqB;QACpC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,sEAAsE;IACtE,YAAY,EAAE,UAAU,CAAmB;QACzC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC;QACvC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;CACH,CAAC,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.strategies.d.ts","sourceRoot":"","sources":["../../../src/shared/hyde/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/shared/hyde/hyde.strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.strategies.js","sourceRoot":"","sources":["../../../src/shared/hyde/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/shared/hyde/lens.inferrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens.inferrer.d.ts","sourceRoot":"","sources":["../../../src/shared/hyde/lens.inferrer.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtD,iFAAiF;AACjF,MAAM,WAAW,IAAI;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,EAAE,gBAAgB,CAAC;IACzB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,EAAE,CAAC;CAChB;AA8BD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAEV;IAEH;;;;;OAKG;IAEG,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoCrE"}

package/dist/{agents → shared/hyde}/lens.inferrer.js

@@ -14,9 +14,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
  */
 import { HumanMessage, SystemMessage } from '@langchain/core/messages';
 import { z } from 'zod';
-import { Timed } from "../support/performance.js";
-import { protocolLogger } from '../support/protocol.logger.js';
-import { createModel } from "./model.config.js";
+import { Timed } from "../observability/performance.js";
+import { protocolLogger } from '../observability/protocol.logger.js';
+import { createModel } from "../agent/model.config.js";
 const SYSTEM_PROMPT = `You analyze goals and search queries to identify the most relevant perspectives for finding matching people in a professional network.
 
 For each perspective you identify, specify:

package/dist/shared/hyde/lens.inferrer.js.map

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

package/dist/shared/interfaces/auth.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.interface.d.ts","sourceRoot":"","sources":["../../../src/shared/interfaces/auth.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD"}

package/dist/shared/interfaces/auth.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.interface.js","sourceRoot":"","sources":["../../../src/shared/interfaces/auth.interface.ts"],"names":[],"mappings":""}

package/dist/shared/interfaces/cache.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.interface.d.ts","sourceRoot":"","sources":["../../../src/shared/interfaces/cache.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,KAAK;IACpB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAE/C;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAMD,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAEzE,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC"}

package/dist/shared/interfaces/cache.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.interface.js","sourceRoot":"","sources":["../../../src/shared/interfaces/cache.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/shared/interfaces/chat-session.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.interface.d.ts","sourceRoot":"","sources":["../../../src/shared/interfaces/chat-session.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QACnE,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC,CAAC;CACL"}

package/dist/shared/interfaces/chat-session.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.interface.js","sourceRoot":"","sources":["../../../src/shared/interfaces/chat-session.interface.ts"],"names":[],"mappings":""}

package/dist/shared/interfaces/contact.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.interface.d.ts","sourceRoot":"","sources":["../../../src/shared/interfaces/contact.interface.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACnE;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5F;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACvD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE"}

package/dist/shared/interfaces/contact.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.interface.js","sourceRoot":"","sources":["../../../src/shared/interfaces/contact.interface.ts"],"names":[],"mappings":""}

package/dist/{interfaces → shared/interfaces}/database.interface.d.ts

@@ -1,4 +1,4 @@
-import { ProfileDocument } from '../agents/profile.generator.js';
+import { ProfileDocument } from '../../profile/profile.generator.js';
 /** Branded string ID for type-safe entity references (keyed by Drizzle table name). */
 export type Id<T extends string = string> = string & {
     readonly __table?: T;
@@ -1441,6 +1441,58 @@ export interface NegotiationDatabase {
     }): Promise<{
         id: string;
     }>;
+    /**
+     * Lists negotiation tasks where the given user is source or candidate.
+     * @param userId - The user ID to filter by (matches sourceUserId or candidateUserId in task metadata)
+     * @param options - Optional status filter
+     * @returns Array of task records with metadata
+     */
+    getTasksForUser(userId: string, options?: {
+        state?: string;
+    }): Promise<Array<{
+        id: string;
+        conversationId: string;
+        state: string;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>>;
+    /**
+     * Gets a specific task by ID.
+     * @param taskId - The task ID to look up
+     * @returns The task record or null if not found
+     */
+    getTask(taskId: string): Promise<{
+        id: string;
+        conversationId: string;
+        state: string;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    /**
+     * Gets all messages for a conversation, ordered by creation time.
+     * @param conversationId - The conversation to fetch messages for
+     * @returns Array of message records
+     */
+    getMessagesForConversation(conversationId: string): Promise<Array<{
+        id: string;
+        senderId: string;
+        role: 'user' | 'agent';
+        parts: unknown[];
+        createdAt: Date;
+    }>>;
+    /**
+     * Gets artifacts for a task (e.g. negotiation outcome).
+     * @param taskId - The task to fetch artifacts for
+     * @returns Array of artifact records
+     */
+    getArtifactsForTask(taskId: string): Promise<Array<{
+        id: string;
+        name: string | null;
+        parts: unknown[];
+        metadata: Record<string, unknown> | null;
+    }>>;
 }
 /**
  * Database interface for opportunity controller (API).