@indexnetwork/protocol 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.indexer.d.ts","sourceRoot":"","sources":["../../src/agents/intent.indexer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAyD5E,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiD;;IAQ9D;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;;;;;OAQG;IAEU,MAAM,CACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAsCtC;;;OAGG;IAEU,QAAQ,CACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAItC;;;OAGG;WACW,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BrB"}

package/dist/agents/intent.indexer.js

@@ -0,0 +1,164 @@
+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";
+import { log } from "../support/log.js";
+import { Timed } from "../support/performance.js";
+import { createModel } from "./model.config.js";
+// ──────────────────────────────────────────────────────────────
+// Response schema
+// ──────────────────────────────────────────────────────────────
+export const IntentIndexerOutputSchema = z.object({
+    indexScore: z.number().min(0).max(1).describe("Score for index appropriateness (0.0-1.0)"),
+    memberScore: z.number().min(0).max(1).describe("Score for member preference match (0.0-1.0)"),
+    reasoning: z.string().describe("Brief reasoning for the scores"),
+});
+const logger = log.lib.from("IntentIndexer");
+/**
+ * Config
+ */
+import { config } from "dotenv";
+config({ path: ".env.development", override: true });
+const model = createModel("intentIndexer");
+// ──────────────────────────────────────────────────────────────
+// 1. SYSTEM PROMPT
+// ──────────────────────────────────────────────────────────────
+const systemPrompt = `
+You are an expert Intent Evaluator for a social networking protocol.
+
+TASK:
+Determine if a User Intent is appropriate for a specific Index (community) and matches a Member's sharing preferences.
+
+INPUTS:
+1. Intent: The content/action the user wants to perform.
+2. Index Prompt: The purpose/scope of the target community (Index).
+3. Member Prompt: The specific sharing preferences of the user in that community (optional).
+4. Source: Origin of the intent (file, link, etc.) (optional).
+
+SCORING RUBRIC:
+- 0.9-1.0: Highly appropriate, perfect match.
+- 0.7-0.8: Good match, relevant.
+- 0.5-0.6: Moderate, borderline.
+- 0.3-0.4: Low appropriateness, poor fit.
+- 0.0-0.2: Not appropriate.
+
+OUTPUT RULES:
+- Provide \`indexScore\` based on how well the Intent fits the Index Prompt.
+- Provide \`memberScore\` based on how well the Intent fits the Member Prompt (if provided). If Member Prompt is missing/empty, return 0.0 for memberScore.
+- Provide concise \`reasoning\`.
+`;
+// ──────────────────────────────────────────────────────────────
+// 2. RESPONSE SCHEMA (Zod)
+// ──────────────────────────────────────────────────────────────
+const responseFormat = IntentIndexerOutputSchema;
+// ──────────────────────────────────────────────────────────────
+// 4. CLASS DEFINITION
+// ──────────────────────────────────────────────────────────────
+export class IntentIndexer {
+    constructor() {
+        this.model = model.withStructuredOutput(responseFormat, {
+            name: "intent_indexer",
+        });
+    }
+    /**
+     * Converts the structured response into a string for logging or embedding.
+     * Used when the output needs to be serialized (e.g. for traces).
+     */
+    toString(output) {
+        return [
+            `indexScore: ${output.indexScore}`,
+            `memberScore: ${output.memberScore}`,
+            `reasoning: ${output.reasoning}`,
+        ].join("\n");
+    }
+    /**
+     * 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.
+     */
+    async invoke(intent, indexPrompt, memberPrompt, sourceName) {
+        logger.verbose("[IntentIndexer.invoke] Evaluating intent");
+        const contextParts = [];
+        if (sourceName)
+            contextParts.push(`Source: ${sourceName}`);
+        contextParts.push(indexPrompt ? `Index Purpose: ${indexPrompt}` : "Index Purpose: (Not provided)");
+        contextParts.push(memberPrompt ? `Member Preferences: ${memberPrompt}` : "Member Preferences: (Not provided)");
+        const prompt = `
+      # Context
+      ${contextParts.join("\n")}
+
+      # Intent
+      ${intent}
+
+      Evaluate the appropriateness of this intent.
+    `;
+        const messages = [
+            new SystemMessage(systemPrompt),
+            new HumanMessage(prompt),
+        ];
+        try {
+            const result = await this.model.invoke(messages);
+            const output = responseFormat.parse(result);
+            logger.verbose("[IntentIndexer.invoke] Evaluation complete", {
+                indexScore: output.indexScore,
+                memberScore: output.memberScore,
+            });
+            return output;
+        }
+        catch (error) {
+            logger.error("[IntentIndexer] Error during execution", { error });
+            return 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().
+     */
+    async evaluate(intent, indexPrompt, memberPrompt, sourceName) {
+        return this.invoke(intent, indexPrompt, memberPrompt, sourceName);
+    }
+    /**
+     * Factory method to expose the agent as a LangChain tool.
+     * Useful for composing agents into larger graphs.
+     */
+    static asTool() {
+        return tool(async (args) => {
+            const agent = new IntentIndexer();
+            return await agent.invoke(args.intent, args.indexPrompt, args.memberPrompt, args.sourceName);
+        }, {
+            name: "intent_indexer",
+            description: "Evaluates whether an intent is appropriate for a specific index (community) and matches member sharing preferences.",
+            schema: z.object({
+                intent: z.string().describe("The intent payload to evaluate"),
+                indexPrompt: z.string().nullable().describe("The purpose of the index (community)"),
+                memberPrompt: z.string().nullable().describe("The member's sharing preferences"),
+                sourceName: z.string().nullable().optional().describe("Optional source name for context"),
+            }),
+        });
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], IntentIndexer.prototype, "invoke", null);
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], IntentIndexer.prototype, "evaluate", null);
+//# sourceMappingURL=intent.indexer.js.map

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

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

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

@@ -0,0 +1,95 @@
+import { BaseMessage } from "@langchain/core/messages";
+import { z } from "zod";
+/**
+ * Options to control inferrer behavior.
+ * Used to implement safety controls for read/write separation.
+ */
+export interface InferrerOptions {
+    /**
+     * Whether to fallback to profile inference when content is empty.
+     * Should be TRUE for create operations without explicit content.
+     * Should be FALSE for query operations.
+     * Default: true (for backward compatibility).
+     */
+    allowProfileFallback?: boolean;
+    /**
+     * The operation mode for context.
+     * Helps inferrer understand the user's intent.
+     */
+    operationMode?: 'create' | 'update' | 'delete';
+    /**
+     * Conversation history for anaphoric resolution.
+     * Used to resolve references like "that intent", "this goal", etc.
+     * Optional - if not provided, inference uses only current content.
+     */
+    conversationContext?: BaseMessage[];
+}
+declare const InferredIntentSchema: z.ZodObject<{
+    type: z.ZodEnum<["goal", "tombstone"]>;
+    description: z.ZodString;
+    reasoning: z.ZodString;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+}, "strip", z.ZodTypeAny, {
+    reasoning: string;
+    confidence: "low" | "medium" | "high";
+    type: "goal" | "tombstone";
+    description: string;
+}, {
+    reasoning: string;
+    confidence: "low" | "medium" | "high";
+    type: "goal" | "tombstone";
+    description: string;
+}>;
+export type InferredIntent = z.infer<typeof InferredIntentSchema>;
+export declare class ExplicitIntentInferrer {
+    private model;
+    constructor();
+    /**
+     * Main entry point. Invokes the agent with input and returns structured output.
+     * @param content - The raw string content to analyze.
+     * @param profileContext - The formatted profile context string.
+     * @param options - Options controlling inference behavior (fallback, operation mode, conversation context).
+     */
+    invoke(content: string | null, profileContext: string, options?: InferrerOptions): Promise<{
+        intents: {
+            reasoning: string;
+            confidence: "low" | "medium" | "high";
+            type: "goal" | "tombstone";
+            description: string;
+        }[];
+    }>;
+    /**
+     * Formats conversation history for inclusion in the prompt.
+     * Converts BaseMessage[] to readable string format.
+     */
+    private formatConversationHistory;
+    /**
+     * 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<{
+        content: z.ZodNullable<z.ZodString>;
+        profileContext: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string | null;
+        profileContext: string;
+    }, {
+        content: string | null;
+        profileContext: string;
+    }>, {
+        content: string | null;
+        profileContext: string;
+    }, {
+        content: string | null;
+        profileContext: string;
+    }, {
+        intents: {
+            reasoning: string;
+            confidence: "low" | "medium" | "high";
+            type: "goal" | "tombstone";
+            description: string;
+        }[];
+    }, unknown, "explicit_intent_inferrer">;
+}
+export {};
+//# sourceMappingURL=intent.inferrer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.inferrer.d.ts","sourceRoot":"","sources":["../../src/agents/intent.inferrer.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAE/C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,WAAW,EAAE,CAAC;CACrC;AA2ED,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;EAKxB,CAAC;AAWH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,KAAK,CAAM;;IAQnB;;;;;OAKG;IAEU,MAAM,CACjB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,eAAoB;;;;;;;;IAuF/B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAuBjC;;;OAGG;WACW,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAgBrB"}

package/dist/agents/intent.inferrer.js

@@ -0,0 +1,238 @@
+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";
+import { protocolLogger } from "../support/protocol.logger.js";
+import { Timed } from "../support/performance.js";
+import { createModel } from "./model.config.js";
+const logger = protocolLogger("ExplicitIntentInferrer");
+/**
+ * Config
+ */
+import { config } from "dotenv";
+config({ path: '.env.development', override: true });
+const model = createModel("intentInferrer");
+// ──────────────────────────────────────────────────────────────
+// 1. SYSTEM PROMPT
+// ──────────────────────────────────────────────────────────────
+const systemPrompt = `
+  You are an expert Intent Analyst. Your goal is to infer the user's current intentions based on their profile and new content.
+
+  You have access to:
+  1. User Memory Profile (Identity, Narrative, Attributes) - The long-term context.
+  2. New Content - What they just said/did.
+  3. Conversation History (when available) - Recent messages for resolving references.
+  4. Operation Context - What type of operation is being performed.
+
+  YOUR TASK:
+  Analyze the "New Content" in the context of the "Profile", "Conversation History", and "Operation Context".
+  Extract a list of **Inferred Intents**.
+
+  INTENT TYPES:
+  - 'goal': The user wants to start, continue, or achieve something. (e.g., "I want to learn Rust", "Looking for a co-founder")
+  - 'tombstone': The user explicitly states they have COMPLETED, stopped, or abandoned a goal. (e.g., "I finished the course", "I'm done with crypto", "Delete my running goal")
+
+  CRITICAL RULES:
+  - Only analyze the "New Content" section if it exists.
+  - If New Content says "Return empty intents list", you MUST return an empty intents array.
+  - If New Content says "No content to analyze", return an empty intents array.
+  - Be precise and self-contained in descriptions (e.g., "Learn Rust programming" instead of "Learn it").
+  - Do NOT try to manage existing IDs or check for duplicates.
+  - IGNORE purely phatic communication (e.g., "Hello", "Hi", "Good morning") - return empty intents.
+  - For CREATE operations: Extract what the user wants to ADD.
+  - For UPDATE operations: Extract what the user wants to CHANGE.
+  - For queries/questions: You should not see these - return empty intents.
+
+  CONTENT GROUNDING (CRITICAL):
+  - When New Content is present, EVERY inferred intent MUST be directly related to the New Content.
+  - The User Profile is ENRICHMENT CONTEXT ONLY — use it to add specificity or domain detail to content-derived intents.
+  - Do NOT generate intents from the profile that are unrelated to the New Content.
+  - If the New Content is a short phrase (e.g., "artist", "photographer"), treat it as the user's stated goal — infer what they want regarding that topic.
+  - Example: New Content = "artist", Profile = "Building a decentralized protocol" → Intent: "Find or connect with artists" (NOT "Secure partnerships for decentralized protocol")
+  - Example: New Content = "looking for a photographer", Profile = "AI startup founder" → Intent: "Find a photographer" (NOT "Recruit AI engineers")
+
+  CONCEPT EXTRACTION (CRITICAL FOR MATCHING):
+  - Intents must be SELF-CONTAINED and understandable to strangers with no prior context.
+  - When a document describes a project, the project's NAME is irrelevant - only WHAT IT DOES and WHAT TECH IT USES matters.
+  - STRIP OUT completely (do not include in any form):
+    * ANY project/company/product names from the source document - these mean nothing to outsiders
+    * URLs and links (https://..., http://...) - NEVER include URLs in intent descriptions
+    * Phrases that reference URLs: "More details at", "See ... for more", "Project details:", "mentioned in", "from the document", "as discussed"
+    * File names ("Claude.md", "README", "the PDF")
+  - Describe the WORK and TECHNOLOGIES, never the project name.
+  - Examples:
+    * Source mentions "FooBar Project" using React/Node → Intent: "Seeking React/Node.js developers for real-time web apps" (NO "FooBar")
+    * Source mentions "Index Network" with LangGraph → Intent: "Seeking LangGraph/PostgreSQL developers for AI agent systems" (NO "Index Network")
+    * Source mentions "Acme Corp" doing ML → Intent: "Seeking ML engineers for computer vision pipelines" (NO "Acme")
+  
+  ANAPHORIC RESOLUTION (UPDATE operations):
+  - When conversation history is provided, use it to resolve references like "that intent", "this goal", "the project", etc.
+  - Look for previously mentioned intents in the conversation history.
+  - If the user says "make that intent X", find what "that intent" refers to in the history and include ALL its details.
+  - PRESERVE all existing details from the referenced intent and only MODIFY the specified parts.
+  - Example: If history mentions "text-based RPG game" and user says "make that intent have LLM narration",
+    the output should be "Create a text-based RPG game with LLM-enhanced narration" (preserving "text-based").
+  
+  WHEN TO FALLBACK TO PROFILE:
+  - Only when explicitly instructed: "(No content provided. Please infer intents from Profile Narrative and Aspirations)"
+  - This should ONLY happen for CREATE operations with no explicit user input
+  - Never infer from profile for query operations
+  - When content IS present: profile may inform HOW to describe the intent (e.g., adding domain context), but must NOT change WHAT the intent is about
+`;
+// ──────────────────────────────────────────────────────────────
+// 2. RESPONSE SCHEMA (Zod)
+// ──────────────────────────────────────────────────────────────
+const InferredIntentSchema = z.object({
+    type: z.enum(['goal', 'tombstone']).describe("The type of intent inferred"),
+    description: z.string().describe("Concise description of the intent"),
+    reasoning: z.string().describe("Why this intent was inferred"),
+    confidence: z.enum(['high', 'medium', 'low']).describe("Confidence level of the inference")
+});
+const responseFormat = z.object({
+    intents: z.array(InferredIntentSchema).describe("List of inferred intents")
+});
+// ──────────────────────────────────────────────────────────────
+// 4. CLASS DEFINITION
+// ──────────────────────────────────────────────────────────────
+export class ExplicitIntentInferrer {
+    constructor() {
+        this.model = model.withStructuredOutput(responseFormat, {
+            name: "intent_inferrer"
+        });
+    }
+    /**
+     * Main entry point. Invokes the agent with input and returns structured output.
+     * @param content - The raw string content to analyze.
+     * @param profileContext - The formatted profile context string.
+     * @param options - Options controlling inference behavior (fallback, operation mode, conversation context).
+     */
+    async invoke(content, profileContext, options = {}) {
+        const { allowProfileFallback = true, // Default TRUE for backward compatibility
+        operationMode = 'create', conversationContext = undefined } = options;
+        logger.verbose("invoke: received input", {
+            contentPreview: content?.substring(0, 50),
+            allowProfileFallback,
+            operationMode,
+            hasConversationContext: !!conversationContext,
+            conversationMessageCount: conversationContext?.length || 0,
+        });
+        // CRITICAL: Don't fallback to profile when explicitly disabled
+        // This prevents auto-generation of intents from profile during query operations
+        if (!content && !allowProfileFallback) {
+            logger.verbose("invoke: no content and fallback disabled, returning empty");
+            return { intents: [] };
+        }
+        // Build conversation history section for anaphoric resolution
+        const formattedHistory = conversationContext && conversationContext.length > 0
+            ? this.formatConversationHistory(conversationContext)
+            : '';
+        const conversationSection = formattedHistory
+            ? `# Conversation History (for reference resolution)\n${formattedHistory}\n`
+            : '';
+        // Build content section based on fallback setting
+        const contentSection = content
+            ? `## New Content\n\n${content}`
+            : allowProfileFallback
+                ? '(No content provided. Please infer intents from Profile Narrative and Aspirations)'
+                : '(No content to analyze. Return empty intents list.)';
+        const prompt = `
+      Context:
+      # User Memory Profile
+      ${profileContext}
+
+      ${conversationSection}${contentSection}
+      
+      # Operation Context
+      This analysis is for a ${operationMode} operation.
+      ${operationMode === 'create' ? 'Extract NEW intents the user wants to add.' : ''}
+      ${operationMode === 'update' ? 'Extract MODIFICATIONS to existing intents. Use conversation history to resolve references like "that intent".' : ''}
+      ${operationMode === 'delete' ? 'This should not execute - delete operations skip inference.' : ''}
+    `;
+        logger.debug("invoke: prompt details", {
+            hasConversationHistory: !!conversationSection,
+            conversationHistoryLength: formattedHistory.length,
+            conversationHistoryPreview: formattedHistory.substring(0, 300),
+            contentLength: content?.length ?? 0,
+            promptLength: prompt.length,
+            promptPreview: prompt.substring(0, 500),
+        });
+        const messages = [
+            new SystemMessage(systemPrompt),
+            new HumanMessage(prompt)
+        ];
+        try {
+            const result = await this.model.invoke(messages);
+            const output = responseFormat.parse(result);
+            logger.verbose(`invoke: found ${output.intents.length} intents`, {
+                operationMode,
+                allowedFallback: allowProfileFallback,
+                usedFallback: !content && allowProfileFallback,
+            });
+            return output;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger.error("invoke: error during invocation", {
+                message: err.message,
+                stack: err.stack,
+            });
+            return { intents: [] };
+        }
+    }
+    /**
+     * Formats conversation history for inclusion in the prompt.
+     * Converts BaseMessage[] to readable string format.
+     */
+    formatConversationHistory(messages) {
+        const formatted = messages.map((msg, index) => {
+            const role = msg._getType() === 'human' ? 'User' : 'Assistant';
+            const content = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+            // Truncate long messages for token efficiency
+            const truncated = content.length > 200 ? content.substring(0, 200) + '...' : content;
+            return `[${index + 1}] ${role}: ${truncated}`;
+        }).join('\n');
+        logger.debug("formatConversationHistory: full conversation history", {
+            messageCount: messages.length,
+            fullHistory: messages
+                .map((msg, index) => {
+                const role = msg._getType() === "human" ? "User" : "Assistant";
+                const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+                return `[${index + 1}] ${role}: ${content}`;
+            })
+                .join("\n"),
+        });
+        return formatted;
+    }
+    /**
+     * Factory method to expose the agent as a LangChain tool.
+     * Useful for composing agents into larger graphs.
+     */
+    static asTool() {
+        return tool(async (args) => {
+            const agent = new ExplicitIntentInferrer();
+            return await agent.invoke(args.content, args.profileContext);
+        }, {
+            name: 'explicit_intent_inferrer',
+            description: 'Extracts explicit intents from user content and profile context.',
+            schema: z.object({
+                content: z.string().nullable().describe('The new content to analyze'),
+                profileContext: z.string().describe('The user profile context')
+            })
+        });
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, Object]),
+    __metadata("design:returntype", Promise)
+], ExplicitIntentInferrer.prototype, "invoke", null);
+//# sourceMappingURL=intent.inferrer.js.map

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

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

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

@@ -0,0 +1,106 @@
+import { z } from "zod";
+declare const CreateIntentActionSchema: z.ZodObject<{
+    type: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"CREATE">]>;
+    payload: z.ZodString;
+    score: z.ZodNullable<z.ZodNumber>;
+    reasoning: z.ZodNullable<z.ZodString>;
+    intentMode: z.ZodNullable<z.ZodEnum<["REFERENTIAL", "ATTRIBUTIVE"]>>;
+    referentialAnchor: z.ZodNullable<z.ZodString>;
+    semanticEntropy: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    reasoning: string | null;
+    payload: string;
+    semanticEntropy: number | null;
+    referentialAnchor: string | null;
+    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
+    type: "create" | "CREATE";
+    score: number | null;
+}, {
+    reasoning: string | null;
+    payload: string;
+    semanticEntropy: number | null;
+    referentialAnchor: string | null;
+    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
+    type: "create" | "CREATE";
+    score: number | null;
+}>;
+declare const UpdateIntentActionSchema: z.ZodObject<{
+    type: z.ZodUnion<[z.ZodLiteral<"update">, z.ZodLiteral<"UPDATE">]>;
+    id: z.ZodString;
+    payload: z.ZodString;
+    score: z.ZodNullable<z.ZodNumber>;
+    reasoning: z.ZodNullable<z.ZodString>;
+    intentMode: z.ZodNullable<z.ZodEnum<["REFERENTIAL", "ATTRIBUTIVE"]>>;
+}, "strip", z.ZodTypeAny, {
+    reasoning: string | null;
+    id: string;
+    payload: string;
+    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
+    type: "update" | "UPDATE";
+    score: number | null;
+}, {
+    reasoning: string | null;
+    id: string;
+    payload: string;
+    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
+    type: "update" | "UPDATE";
+    score: number | null;
+}>;
+declare const ExpireIntentActionSchema: z.ZodObject<{
+    type: z.ZodUnion<[z.ZodLiteral<"expire">, z.ZodLiteral<"EXPIRE">]>;
+    id: z.ZodString;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "expire" | "EXPIRE";
+    reason: string;
+}, {
+    id: string;
+    type: "expire" | "EXPIRE";
+    reason: string;
+}>;
+export type NormalizedIntentAction = Omit<z.infer<typeof CreateIntentActionSchema>, "type"> & {
+    type: "create";
+} | Omit<z.infer<typeof UpdateIntentActionSchema>, "type"> & {
+    type: "update";
+} | Omit<z.infer<typeof ExpireIntentActionSchema>, "type"> & {
+    type: "expire";
+};
+export type IntentReconcilerOutput = {
+    actions: NormalizedIntentAction[];
+};
+export declare class IntentReconciler {
+    private model;
+    constructor();
+    /**
+     * Reconciles inferred intents with active intents.
+     * @param inferredIntentsFormatted - Formatted string of inferred intents.
+     * @param activeIntentsContext - Formatted string of active intents.
+     */
+    invoke(inferredIntentsFormatted: string, activeIntentsContext: string): Promise<{
+        actions: NormalizedIntentAction[];
+    }>;
+    /**
+     * Factory method to expose the agent as a LangChain tool.
+     */
+    static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        inferredIntents: z.ZodString;
+        activeIntents: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        inferredIntents: string;
+        activeIntents: string;
+    }, {
+        inferredIntents: string;
+        activeIntents: string;
+    }>, {
+        inferredIntents: string;
+        activeIntents: string;
+    }, {
+        inferredIntents: string;
+        activeIntents: string;
+    }, {
+        actions: NormalizedIntentAction[];
+    }, unknown, "intent_reconciler">;
+}
+export {};
+//# sourceMappingURL=intent.reconciler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.reconciler.d.ts","sourceRoot":"","sources":["../../src/agents/intent.reconciler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyExB,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AAEH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;EAI5B,CAAC;AAcH,MAAM,MAAM,sBAAsB,GAC9B,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3E,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3E,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IAAE,OAAO,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAAC;AAe3E,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAM;;IAQnB;;;;OAIG;IAEU,MAAM,CAAC,wBAAwB,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;;;IAqClF;;OAEG;WACW,MAAM;;;;;;;;;;;;;;;;;;CAgBrB"}