@lapage/ai-agent 1.0.0

package/dist/tools/mcp-client.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMcpServerTools = getMcpServerTools;
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const sse_js_1 = require("@modelcontextprotocol/sdk/client/sse.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const tools_1 = require("@langchain/core/tools");
+const zod_1 = require("zod");
+const json_schema_to_zod_1 = require("./json-schema-to-zod");
+/**
+ * Recursively fetch all tools from the MCP server, following pagination cursors.
+ */
+async function getAllMcpTools(client, cursor) {
+    const { tools, nextCursor } = await client.listTools({ cursor });
+    const mcpTools = tools;
+    if (nextCursor) {
+        return mcpTools.concat(await getAllMcpTools(client, nextCursor));
+    }
+    return mcpTools;
+}
+/**
+ * Convert an MCP tool definition to a LangChain DynamicStructuredTool.
+ * The JSON Schema inputSchema is converted to a Zod object schema so the
+ * agent can validate and pass structured arguments.
+ */
+function mcpToolToLangChainTool(tool, client, timeout) {
+    const rawSchema = (0, json_schema_to_zod_1.convertJsonSchemaToZod)(tool.inputSchema);
+    // DynamicStructuredTool requires a ZodObject at the top level
+    const objectSchema = rawSchema instanceof zod_1.z.ZodObject ? rawSchema : zod_1.z.object({ value: rawSchema });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return new tools_1.DynamicStructuredTool({
+        name: tool.name,
+        description: tool.description ?? '',
+        schema: objectSchema,
+        func: async (args) => {
+            try {
+                const result = await client.callTool({ name: tool.name, arguments: args }, types_js_1.CompatibilityCallToolResultSchema, { timeout });
+                if (result.isError) {
+                    const errorMsg = extractTextFromContent(result) ?? `Tool "${tool.name}" returned an error`;
+                    return errorMsg;
+                }
+                if (result.toolResult !== undefined) {
+                    return typeof result.toolResult === 'string'
+                        ? result.toolResult
+                        : JSON.stringify(result.toolResult);
+                }
+                if (result.content !== undefined) {
+                    const text = extractTextFromContent(result);
+                    return text ?? JSON.stringify(result.content);
+                }
+                return JSON.stringify(result);
+            }
+            catch (error) {
+                return `Error calling MCP tool "${tool.name}": ${error instanceof Error ? error.message : String(error)}`;
+            }
+        },
+        metadata: { mcpTool: true, mcpServer: tool.name },
+    });
+}
+function extractTextFromContent(result) {
+    if (result?.content && Array.isArray(result.content)) {
+        const textEntry = result.content.find((c) => c.type === 'text' && typeof c.text === 'string');
+        return textEntry?.text;
+    }
+    return undefined;
+}
+/**
+ * Connect to an MCP server and return its tools as LangChain DynamicStructuredTool instances.
+ * Supports both SSE and HTTP Streamable transports.
+ */
+async function getMcpServerTools(config) {
+    const { url, transport = 'httpStreamable', headers, name = 'ai-agent-mcp-client', timeout = 60_000, toolMode = 'all', includeTools, excludeTools, } = config;
+    const endpointUrl = normalizeUrl(url);
+    const client = new index_js_1.Client({ name, version: '1' }, { capabilities: {} });
+    if (transport === 'httpStreamable') {
+        const httpTransport = new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(endpointUrl), {
+            requestInit: { headers },
+        });
+        await client.connect(httpTransport);
+    }
+    else {
+        const sseTransport = new sse_js_1.SSEClientTransport(new URL(endpointUrl), {
+            eventSourceInit: {
+                fetch: async (url, init) => fetch(url, {
+                    ...init,
+                    headers: {
+                        ...(init?.headers ?? {}),
+                        ...(headers ?? {}),
+                        Accept: 'text/event-stream',
+                    },
+                }),
+            },
+            requestInit: { headers },
+        });
+        await client.connect(sseTransport);
+    }
+    const allTools = await getAllMcpTools(client);
+    const filteredTools = filterTools(allTools, toolMode, includeTools, excludeTools);
+    return filteredTools.map((tool) => mcpToolToLangChainTool(tool, client, timeout));
+}
+function normalizeUrl(url) {
+    if (!/^https?:\/\//i.test(url)) {
+        return `https://${url}`;
+    }
+    return url;
+}
+function filterTools(tools, mode, includeTools, excludeTools) {
+    switch (mode) {
+        case 'selected': {
+            if (!includeTools?.length)
+                return tools;
+            const include = new Set(includeTools);
+            return tools.filter((t) => include.has(t.name));
+        }
+        case 'except': {
+            const except = new Set(excludeTools ?? []);
+            return tools.filter((t) => !except.has(t.name));
+        }
+        case 'all':
+        default:
+            return tools;
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/tools/mcp-client.js.map

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

package/dist/tools/vector-tools.d.ts

@@ -0,0 +1,44 @@
+import type { Embeddings } from '@langchain/core/embeddings';
+import { ToolOptions } from '../types';
+export interface PGVectorConfig {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    tableName?: string;
+    collectionName?: string;
+    collectionTableName?: string;
+    columns?: {
+        idColumnName?: string;
+        vectorColumnName?: string;
+        contentColumnName?: string;
+        metadataColumnName?: string;
+    };
+}
+export interface RetrieveDocumentsConfig {
+    pgConfig: PGVectorConfig;
+    embeddings: Embeddings;
+    topK?: number;
+    includeMetadata?: boolean;
+    metadataFilter?: Record<string, any>;
+}
+/**
+ * Output format options for the vector search tool
+ */
+export type VectorSearchOutputFormat = 'structured' | 'n8n' | 'simple';
+export interface VectorSearchToolConfig extends RetrieveDocumentsConfig {
+    /** Tool name (defaults to 'search_documents') */
+    toolName?: string;
+    /** Tool description */
+    toolDescription?: string;
+    /** Output format for results */
+    outputFormat?: VectorSearchOutputFormat;
+    /** Whether to allow dynamic topK parameter */
+    allowDynamicTopK?: boolean;
+}
+/**
+ * Creates a unified vector search tool with configurable behavior
+ */
+export declare function createVectorSearchTool(config: VectorSearchToolConfig): ToolOptions;
+//# sourceMappingURL=vector-tools.d.ts.map

package/dist/tools/vector-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-tools.d.ts","sourceRoot":"","sources":["../../src/tools/vector-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AAoFD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAmGD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,WAAW,CAiDb"}

package/dist/tools/vector-tools.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVectorSearchTool = createVectorSearchTool;
+const pgvector_1 = require("@langchain/community/vectorstores/pgvector");
+const zod_1 = require("zod");
+/**
+ * Extended PGVectorStore class to handle custom filtering.
+ * This wrapper is necessary because when used as a retriever,
+ * similaritySearchVectorWithScore should use this.filter instead of
+ * expecting it from the parameter
+ */
+class ExtendedPGVectorStore extends pgvector_1.PGVectorStore {
+    static async initialize(embeddings, args) {
+        const { dimensions, ...rest } = args;
+        const postgresqlVectorStore = new this(embeddings, rest);
+        await postgresqlVectorStore._initializeClient();
+        await postgresqlVectorStore.ensureTableInDatabase(dimensions);
+        if (postgresqlVectorStore.collectionTableName) {
+            await postgresqlVectorStore.ensureCollectionTableInDatabase();
+        }
+        return postgresqlVectorStore;
+    }
+    async similaritySearchVectorWithScore(query, k, filter) {
+        const mergedFilter = { ...this.filter, ...filter };
+        return await super.similaritySearchVectorWithScore(query, k, mergedFilter);
+    }
+}
+/**
+ * Creates a PostgreSQL connection pool
+ */
+function createPostgresPool(config) {
+    const Pool = require('pg').Pool;
+    return new Pool({
+        host: config.host,
+        port: config.port,
+        database: config.database,
+        user: config.user,
+        password: config.password,
+        max: 20,
+        idleTimeoutMillis: 30000,
+        connectionTimeoutMillis: 2000,
+    });
+}
+/**
+ * Creates a PGVector store configuration
+ */
+function createPGVectorConfig(config, pool, filter) {
+    const pgVectorConfig = {
+        pool,
+        tableName: config.tableName || 'ai_agent_vectors',
+        filter,
+    };
+    if (config.collectionName) {
+        pgVectorConfig.collectionName = config.collectionName;
+        pgVectorConfig.collectionTableName =
+            config.collectionTableName || 'ai_agent_vector_collections';
+    }
+    if (config.columns) {
+        pgVectorConfig.columns = {
+            idColumnName: config.columns.idColumnName || 'id',
+            vectorColumnName: config.columns.vectorColumnName || 'embedding',
+            contentColumnName: config.columns.contentColumnName || 'text',
+            metadataColumnName: config.columns.metadataColumnName || 'metadata',
+        };
+    }
+    return pgVectorConfig;
+}
+/**
+ * Core function to perform vector similarity search
+ */
+async function performVectorSearch(query, config, topK) {
+    // Create PostgreSQL pool
+    const pool = createPostgresPool(config.pgConfig);
+    try {
+        // Create PGVector configuration
+        const pgVectorConfig = createPGVectorConfig(config.pgConfig, pool, config.metadataFilter);
+        // Initialize the vector store
+        const vectorStore = await ExtendedPGVectorStore.initialize(config.embeddings, pgVectorConfig);
+        try {
+            // Embed the query
+            const embeddedQuery = await config.embeddings.embedQuery(query);
+            // Search for similar documents
+            return await vectorStore.similaritySearchVectorWithScore(embeddedQuery, topK, config.metadataFilter);
+        }
+        finally {
+            // Release the vector store client
+            vectorStore.client?.release();
+        }
+    }
+    finally {
+        // Close the pool
+        await pool.end();
+    }
+}
+/**
+ * Format search results based on the specified output format
+ */
+function formatSearchResults(documents, format, includeMetadata) {
+    switch (format) {
+        case 'structured':
+            const results = documents.map(([doc, score]) => {
+                const result = {
+                    pageContent: doc.pageContent,
+                    score: score,
+                };
+                if (includeMetadata) {
+                    result.metadata = doc.metadata;
+                }
+                return result;
+            });
+            return JSON.stringify({
+                success: true,
+                documents: results,
+                count: results.length,
+            });
+        case 'n8n':
+            return documents
+                .map(([doc]) => {
+                if (includeMetadata) {
+                    return { type: 'text', text: JSON.stringify(doc) };
+                }
+                return {
+                    type: 'text',
+                    text: JSON.stringify({ pageContent: doc.pageContent }),
+                };
+            })
+                .filter((document) => !!document);
+        case 'simple':
+        default:
+            return documents.map(([doc, score]) => ({
+                content: doc.pageContent,
+                score: score,
+                ...(includeMetadata && { metadata: doc.metadata }),
+            }));
+    }
+}
+/**
+ * Creates a unified vector search tool with configurable behavior
+ */
+function createVectorSearchTool(config) {
+    const { toolName = 'search_documents', toolDescription = 'Search for relevant documents using vector similarity search.', outputFormat = 'simple', allowDynamicTopK = true, ...searchConfig } = config;
+    const baseSchema = zod_1.z.object({
+        query: zod_1.z.string().describe('The search query to find similar documents'),
+    });
+    let schema;
+    if (allowDynamicTopK) {
+        schema = baseSchema.extend({
+            topK: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .nullable()
+                .describe(`Number of documents to retrieve (1-50). Pass null to use the default value (${searchConfig.topK || 4})`),
+        });
+    }
+    else {
+        schema = baseSchema;
+    }
+    return {
+        name: toolName,
+        description: toolDescription,
+        schema,
+        func: async (args) => {
+            const { query } = args;
+            const topK = allowDynamicTopK
+                ? args.topK ?? searchConfig.topK ?? 4
+                : searchConfig.topK || 4;
+            const documents = await performVectorSearch(query, searchConfig, topK);
+            return formatSearchResults(documents, outputFormat, searchConfig.includeMetadata !== false);
+        },
+    };
+}
+//# sourceMappingURL=vector-tools.js.map

package/dist/tools/vector-tools.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,158 @@
+import type { JSONSchema7 } from 'json-schema';
+import type { z } from 'zod';
+export interface AgentAction {
+    /** Name of the tool to execute */
+    tool: string;
+    /** Input parameters for the tool */
+    toolInput: any;
+    /** Tool call ID for tracking */
+    toolCallId: string;
+    /** Log message for the action */
+    log: string;
+    /** Array of messages in the conversation */
+    messageLog: any[];
+}
+export interface AgentStep {
+    /** The action taken by the agent */
+    action: AgentAction;
+    /** The observation/result from executing the action */
+    observation: string;
+}
+export interface AIAgentOptions {
+    /** The chat model to use for the agent */
+    model: ModelConfig;
+    /** System message to provide context to the agent */
+    systemMessage?: string;
+    /** Maximum number of iterations the agent can perform */
+    maxIterations?: number;
+    /** Whether to return intermediate steps in the response */
+    returnIntermediateSteps?: boolean;
+    /** Whether to passthrough binary images */
+    passthroughBinaryImages?: boolean;
+    /** Memory configuration for conversation history */
+    memory?: MemoryConfig;
+    /** Array of tools available to the agent */
+    tools?: ToolOptions[];
+    /** Knowledge bases configuration for automatic vector search tools */
+    knowledgeBases?: KnowledgeBaseConfig[];
+    /** MCP server configurations for automatic tool registration */
+    mcpServers?: MCPServerConfig[];
+}
+export interface ModelConfig {
+    provider: 'openai' | 'anthropic';
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    apiKey?: string;
+}
+export interface EmbeddingsConfig {
+    provider: 'openai' | 'cohere' | 'huggingface';
+    model: string;
+    apiKey?: string;
+}
+export interface MemoryConfig {
+    /** Type of memory to use */
+    type?: 'buffer-window' | 'summary' | 'postgres';
+    /** Session ID for memory isolation. Auto-generated if not provided */
+    sessionId?: string;
+    /** For buffer window memory - number of messages to keep */
+    contextWindowLength?: number;
+    /** PostgreSQL configuration for postgres memory type */
+    postgresConfig?: PostgresConfig;
+}
+export interface AIAgentResponse {
+    /** The final output from the agent */
+    output: string;
+    /** Intermediate steps if returnIntermediateSteps is true */
+    intermediateSteps?: AgentStep[];
+    /** Error if execution failed */
+    error?: string;
+}
+export interface PostgresConfig {
+    /** Postgres host */
+    host: string;
+    /** Postgres port */
+    port?: number;
+    /** Database name */
+    database: string;
+    /** Username for Postgres connection */
+    user: string;
+    /** Password for Postgres connection */
+    password: string;
+    /** Table name for storing chat messages */
+    tableName?: string;
+}
+export interface ToolOptions {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Tool function */
+    func: (...args: any[]) => Promise<string> | string;
+    /** Tool schema for parameters - Zod schema or JSON Schema 7 defining the input structure */
+    schema?: z.ZodSchema | JSONSchema7;
+}
+/**
+ * Configuration for connecting to an MCP (Model Context Protocol) server.
+ * The agent will automatically register all tools exposed by the server.
+ */
+export interface MCPServerConfig {
+    /** The endpoint URL of the MCP server */
+    url: string;
+    /** Transport protocol to use (defaults to 'httpStreamable') */
+    transport?: 'sse' | 'httpStreamable';
+    /** Optional HTTP headers for authentication (e.g. Bearer token) */
+    headers?: Record<string, string>;
+    /** Display name for this MCP client (used in SDK metadata) */
+    name?: string;
+    /** Tool call timeout in milliseconds (defaults to 60000) */
+    timeout?: number;
+    /** Which tools to expose from this server */
+    toolMode?: 'all' | 'selected' | 'except';
+    /** Tools to include when toolMode is 'selected' */
+    includeTools?: string[];
+    /** Tools to exclude when toolMode is 'except' */
+    excludeTools?: string[];
+}
+export interface KnowledgeBaseConfig {
+    /** Name of the knowledge base (used as tool name) */
+    name: string;
+    /** Description to help the AI Agent understand when to query this knowledge base */
+    description: string;
+    /** PostgreSQL configuration for the vector store */
+    pgConfig: PGVectorConfig;
+    /** Embeddings configuration for the vector search */
+    embeddings: EmbeddingsConfig;
+    /** Number of documents to retrieve by default */
+    topK?: number;
+    /** Whether to include metadata in search results */
+    includeMetadata?: boolean;
+    /** Optional metadata filter to apply to searches */
+    metadataFilter?: Record<string, any>;
+}
+export interface PGVectorConfig {
+    /** Postgres host */
+    host: string;
+    /** Postgres port */
+    port: number;
+    /** Database name */
+    database: string;
+    /** Username for Postgres connection */
+    user: string;
+    /** Password for Postgres connection */
+    password: string;
+    /** Table name for storing vectors */
+    tableName?: string;
+    /** Collection name for organizing vectors */
+    collectionName?: string;
+    /** Collection table name */
+    collectionTableName?: string;
+    /** Custom column configuration */
+    columns?: {
+        idColumnName?: string;
+        vectorColumnName?: string;
+        contentColumnName?: string;
+        metadataColumnName?: string;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,GAAG,CAAC;IACf,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,UAAU,EAAE,GAAG,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,KAAK,EAAE,WAAW,CAAC;IAEnB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2DAA2D;IAC3D,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,2CAA2C;IAC3C,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,oDAAoD;IACpD,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IAEtB,sEAAsE;IACtE,cAAc,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEvC,gEAAgE;IAChE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,IAAI,CAAC,EAAE,eAAe,GAAG,SAAS,GAAG,UAAU,CAAC;IAEhD,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC;IAEhC,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB,oBAAoB;IACpB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAEnD,4FAA4F;IAC5F,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,GAAG,WAAW,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IAEZ,+DAA+D;IAC/D,SAAS,CAAC,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAErC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IAEzC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,cAAc,CAAC;IACzB,qDAAqD;IACrD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@lapage/ai-agent",
+  "version": "1.0.0",
+  "description": "Standalone AI Agent library built on LangChain with MCP tool calling, memory, and vector knowledge base support",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rm -rf dist",
+    "validate": "node validate.js",
+    "prepublishOnly": "npm run clean && npm run build && npm run validate",
+    "demo:postgres": "NODE_NO_WARNINGS=1 dotenv -- ts-node examples/postgres-demo.ts",
+    "demo:basic": "NODE_NO_WARNINGS=1 dotenv -- ts-node examples/basic-usage.ts",
+    "demo:openai": "NODE_NO_WARNINGS=1 dotenv -- ts-node examples/openai-examples.ts",
+    "demo:anthropic": "NODE_NO_WARNINGS=1 dotenv -- ts-node examples/anthropic-examples.ts"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "langchain",
+    "tools",
+    "llm",
+    "chat"
+  ],
+  "author": "Huy Lan",
+  "license": "MIT",
+  "dependencies": {
+    "@langchain/community": "^0.3.0",
+    "@langchain/core": "^0.3.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@types/json-schema": "^7.0.15",
+    "langchain": "^0.3.0",
+    "lodash": "^4.17.21",
+    "pg": "^8.16.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.6.0",
+    "@langchain/anthropic": "^0.3.34",
+    "@langchain/openai": "^0.3.17",
+    "@types/jest": "^29.5.14",
+    "@types/lodash": "^4.14.195",
+    "@types/node": "^18.17.0",
+    "@types/pg": "^8.15.2",
+    "@typescript-eslint/eslint-plugin": "^5.62.0",
+    "@typescript-eslint/parser": "^5.62.0",
+    "dotenv-cli": "^11.0.0",
+    "eslint": "^8.45.0",
+    "jest": "^29.6.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.1.6"
+  },
+  "peerDependencies": {
+    "@langchain/anthropic": "^0.3.34",
+    "@langchain/openai": "^0.3.17"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/anthropic": {
+      "optional": true
+    },
+    "@langchain/openai": {
+      "optional": true
+    }
+  }
+}