@agenticc/core 1.0.0

package/dist/knowledge/store.js

@@ -0,0 +1,420 @@
+/**
+ * Knowledge Store
+ *
+ * In-memory document storage with semantic search for RAG (Retrieval-Augmented Generation).
+ *
+ * **Why In-Memory?**
+ * - RAG requires fast semantic search during conversation processing
+ * - Documents are typically loaded at application startup
+ * - Embeddings are expensive to generate (cached in memory for performance)
+ * - Conversation history is stored externally (database), but knowledge is cached
+ *
+ * **Design Philosophy:**
+ * - Knowledge documents are relatively static (updated infrequently)
+ * - Fast retrieval is critical for responsive agent interactions
+ * - In-memory storage provides sub-millisecond search performance
+ * - For large knowledge bases, consider implementing pagination or lazy loading
+ *
+ * **For Production:**
+ * - Load documents at startup from files or database
+ * - Use document versioning to detect changes
+ * - Implement periodic refresh if documents change
+ * - Consider distributed caching (Redis) for multi-instance deployments
+ *
+ * Handles storage and retrieval of knowledge documents.
+ * Supports document CRUD operations with embedding generation.
+ * Includes automatic text chunking for large documents.
+ *
+ * _Requirements: 3.1, 3.5, 3.6_
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { cosineSimilarity } from './embedder.js';
+import { TextChunker } from './chunker.js';
+const DEFAULT_CONFIG = {
+    embedder: undefined,
+    generateEmbeddings: true,
+    defaultTopK: 10,
+    defaultMinScore: 0.5,
+    chunkerConfig: undefined,
+    enableChunking: true,
+};
+/**
+ * In-memory Knowledge Store implementation
+ *
+ * Provides document storage with optional embedding generation
+ * and semantic search capabilities.
+ */
+export class KnowledgeStore {
+    documents = new Map();
+    config;
+    chunker;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.chunker = new TextChunker(config?.chunkerConfig);
+    }
+    /**
+     * Add a document to the knowledge base
+     * Generates embedding if embedder is configured
+     * Automatically chunks large documents
+     *
+     * @returns Document ID (or parent document ID if chunked)
+     */
+    async addDocument(doc) {
+        // Check if document needs chunking
+        if (this.config.enableChunking && this.chunker.needsChunking(doc.content)) {
+            return this.addChunkedDocument(doc);
+        }
+        return this.addSingleDocument(doc);
+    }
+    /**
+     * Add a single document (no chunking)
+     */
+    async addSingleDocument(doc, chunkInfo) {
+        const id = uuidv4();
+        const now = new Date();
+        let embedding;
+        // Generate embedding if configured
+        if (this.config.generateEmbeddings && this.config.embedder) {
+            try {
+                const result = await this.config.embedder.embed(doc.content);
+                embedding = result.embedding;
+            }
+            catch (error) {
+                console.warn('Failed to generate embedding:', error);
+                // Continue without embedding
+            }
+        }
+        const storedDoc = {
+            id,
+            category: doc.category,
+            title: doc.title,
+            content: doc.content,
+            metadata: doc.metadata ?? {},
+            embedding,
+            createdAt: now,
+            updatedAt: now,
+            ...(chunkInfo && {
+                parentId: chunkInfo.parentId,
+                chunkIndex: chunkInfo.chunkIndex,
+                totalChunks: chunkInfo.totalChunks,
+            }),
+        };
+        this.documents.set(id, storedDoc);
+        return id;
+    }
+    /**
+     * Add a large document by chunking it
+     */
+    async addChunkedDocument(doc) {
+        const parentId = uuidv4();
+        const chunks = this.chunker.chunk(doc.content);
+        const totalChunks = chunks.length;
+        console.log(`Chunking document "${doc.title}" into ${totalChunks} chunks`);
+        // Add each chunk as a separate document
+        for (const chunk of chunks) {
+            const chunkTitle = doc.title
+                ? `${doc.title} [${chunk.index + 1}/${totalChunks}]`
+                : `Chunk ${chunk.index + 1}/${totalChunks}`;
+            await this.addSingleDocument({
+                category: doc.category,
+                title: chunkTitle,
+                content: chunk.content,
+                metadata: {
+                    ...doc.metadata,
+                    _isChunk: true,
+                    _chunkIndex: chunk.index,
+                    _totalChunks: totalChunks,
+                    _startPos: chunk.startPos,
+                    _endPos: chunk.endPos,
+                },
+            }, {
+                parentId,
+                chunkIndex: chunk.index,
+                totalChunks,
+            });
+        }
+        return parentId;
+    }
+    /**
+     * Get a document by ID
+     */
+    async getDocument(id) {
+        const doc = this.documents.get(id);
+        if (!doc) {
+            return null;
+        }
+        // Return without embedding (internal detail)
+        return this.toDocument(doc);
+    }
+    /**
+     * Delete a document by ID
+     */
+    async deleteDocument(id) {
+        return this.documents.delete(id);
+    }
+    /**
+     * Update a document
+     */
+    async updateDocument(id, updates) {
+        const doc = this.documents.get(id);
+        if (!doc) {
+            return false;
+        }
+        // Update fields
+        if (updates.category !== undefined) {
+            doc.category = updates.category;
+        }
+        if (updates.title !== undefined) {
+            doc.title = updates.title;
+        }
+        if (updates.metadata !== undefined) {
+            doc.metadata = updates.metadata;
+        }
+        // If content changed, regenerate embedding
+        if (updates.content !== undefined) {
+            doc.content = updates.content;
+            if (this.config.generateEmbeddings && this.config.embedder) {
+                try {
+                    const result = await this.config.embedder.embed(updates.content);
+                    doc.embedding = result.embedding;
+                }
+                catch (error) {
+                    console.warn('Failed to regenerate embedding:', error);
+                }
+            }
+        }
+        doc.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Search the knowledge base
+     */
+    async search(query, options) {
+        const method = options?.method ?? 'hybrid';
+        const topK = options?.topK ?? this.config.defaultTopK;
+        const minScore = options?.minScore ?? this.config.defaultMinScore;
+        const category = options?.category;
+        let results;
+        switch (method) {
+            case 'keyword':
+                results = this.keywordSearch(query, category);
+                break;
+            case 'semantic':
+                results = await this.semanticSearch(query, category);
+                break;
+            case 'hybrid':
+            default:
+                results = await this.hybridSearch(query, category);
+                break;
+        }
+        // Filter by minimum score and limit results
+        return results.filter((r) => r.score >= minScore).slice(0, topK);
+    }
+    /**
+     * List all categories
+     */
+    async listCategories() {
+        const categories = new Set();
+        for (const doc of this.documents.values()) {
+            categories.add(doc.category);
+        }
+        return Array.from(categories).sort();
+    }
+    /**
+     * Get documents by category
+     */
+    async getDocumentsByCategory(category) {
+        const results = [];
+        for (const doc of this.documents.values()) {
+            if (doc.category === category) {
+                results.push(this.toDocument(doc));
+            }
+        }
+        return results;
+    }
+    /**
+     * Get all documents
+     */
+    async getAllDocuments() {
+        return Array.from(this.documents.values()).map((doc) => this.toDocument(doc));
+    }
+    /**
+     * Get document count
+     */
+    getDocumentCount() {
+        return this.documents.size;
+    }
+    /**
+     * Check if a document has an embedding
+     */
+    hasEmbedding(id) {
+        const doc = this.documents.get(id);
+        return doc?.embedding !== undefined && doc.embedding.length > 0;
+    }
+    /**
+     * Get the embedding for a document
+     */
+    getEmbedding(id) {
+        return this.documents.get(id)?.embedding;
+    }
+    /**
+     * Get the embedding dimension (from first document with embedding)
+     */
+    getEmbeddingDimension() {
+        for (const doc of this.documents.values()) {
+            if (doc.embedding && doc.embedding.length > 0) {
+                return doc.embedding.length;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Clear all documents
+     */
+    clear() {
+        this.documents.clear();
+    }
+    /**
+     * Keyword-based search using simple text matching
+     */
+    keywordSearch(query, category) {
+        const queryLower = query.toLowerCase();
+        const queryTerms = queryLower.split(/\s+/).filter((t) => t.length > 0);
+        const results = [];
+        for (const doc of this.documents.values()) {
+            // Filter by category if specified
+            if (category && doc.category !== category) {
+                continue;
+            }
+            const contentLower = doc.content.toLowerCase();
+            const titleLower = (doc.title ?? '').toLowerCase();
+            // Calculate keyword match score
+            let matchCount = 0;
+            for (const term of queryTerms) {
+                if (contentLower.includes(term) || titleLower.includes(term)) {
+                    matchCount++;
+                }
+            }
+            if (matchCount > 0) {
+                const score = matchCount / queryTerms.length;
+                results.push({
+                    document: this.toDocument(doc),
+                    score,
+                    confidence: this.scoreToConfidence(score),
+                });
+            }
+        }
+        // Sort by score descending
+        return results.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Semantic search using embedding similarity
+     */
+    async semanticSearch(query, category) {
+        if (!this.config.embedder) {
+            // Fall back to keyword search if no embedder
+            return this.keywordSearch(query, category);
+        }
+        // Generate query embedding
+        let queryEmbedding;
+        try {
+            const result = await this.config.embedder.embed(query);
+            queryEmbedding = result.embedding;
+        }
+        catch (error) {
+            console.warn('Failed to generate query embedding:', error);
+            return this.keywordSearch(query, category);
+        }
+        const results = [];
+        for (const doc of this.documents.values()) {
+            // Filter by category if specified
+            if (category && doc.category !== category) {
+                continue;
+            }
+            // Skip documents without embeddings
+            if (!doc.embedding || doc.embedding.length === 0) {
+                continue;
+            }
+            // Calculate cosine similarity
+            try {
+                const score = cosineSimilarity(queryEmbedding, doc.embedding);
+                // Normalize score to 0-1 range (cosine similarity is -1 to 1)
+                const normalizedScore = (score + 1) / 2;
+                results.push({
+                    document: this.toDocument(doc),
+                    score: normalizedScore,
+                    confidence: this.scoreToConfidence(normalizedScore),
+                });
+            }
+            catch (error) {
+                // Skip documents with incompatible embeddings
+                console.warn(`Skipping document ${doc.id} due to embedding error:`, error);
+            }
+        }
+        // Sort by score descending
+        return results.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Hybrid search combining keyword and semantic results
+     */
+    async hybridSearch(query, category) {
+        const keywordResults = this.keywordSearch(query, category);
+        const semanticResults = await this.semanticSearch(query, category);
+        // Merge results with weighted scores
+        const scoreMap = new Map();
+        for (const result of keywordResults) {
+            scoreMap.set(result.document.id, { keyword: result.score, semantic: 0 });
+        }
+        for (const result of semanticResults) {
+            const existing = scoreMap.get(result.document.id);
+            if (existing) {
+                existing.semantic = result.score;
+            }
+            else {
+                scoreMap.set(result.document.id, { keyword: 0, semantic: result.score });
+            }
+        }
+        // Calculate combined scores (weighted average)
+        const keywordWeight = 0.3;
+        const semanticWeight = 0.7;
+        const results = [];
+        for (const [id, scores] of scoreMap.entries()) {
+            const doc = this.documents.get(id);
+            if (!doc)
+                continue;
+            const combinedScore = scores.keyword * keywordWeight + scores.semantic * semanticWeight;
+            results.push({
+                document: this.toDocument(doc),
+                score: combinedScore,
+                confidence: this.scoreToConfidence(combinedScore),
+            });
+        }
+        // Sort by score descending
+        return results.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Convert score to confidence level
+     */
+    scoreToConfidence(score) {
+        if (score >= 0.8)
+            return 'high';
+        if (score >= 0.5)
+            return 'medium';
+        return 'low';
+    }
+    /**
+     * Convert stored document to public document (without embedding)
+     */
+    toDocument(doc) {
+        return {
+            id: doc.id,
+            category: doc.category,
+            title: doc.title,
+            content: doc.content,
+            metadata: doc.metadata,
+            createdAt: doc.createdAt,
+            updatedAt: doc.updatedAt,
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/knowledge/store.js.map

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

package/dist/llm/adapter.d.ts

@@ -0,0 +1,194 @@
+/**
+ * LLM Adapter Interface
+ *
+ * Defines the common interface for all LLM providers.
+ * Each provider (OpenAI, Claude, Qwen, etc.) implements this interface.
+ */
+import type { ToolDefinition } from '../types/tool.js';
+/**
+ * Options for text generation
+ */
+export interface GenerateOptions {
+    /** Temperature for response generation (0-2) */
+    temperature?: number;
+    /** Maximum tokens in response */
+    maxTokens?: number;
+    /** Stop sequences */
+    stopSequences?: string[];
+    /** System prompt */
+    systemPrompt?: string;
+    /** Additional provider-specific options */
+    options?: Record<string, unknown>;
+    /** Abort signal for cancellation */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Message in a conversation
+ */
+export interface ChatMessage {
+    /** Role of the message sender */
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    /** Message content */
+    content: string;
+    /** Tool call ID (for tool responses) */
+    toolCallId?: string;
+    /** Tool name (for tool responses) */
+    toolName?: string;
+    /** Tool calls requested by assistant (for assistant messages) */
+    toolCalls?: ToolCall[];
+}
+/**
+ * Tool call requested by the LLM
+ */
+export interface ToolCall {
+    /** Unique ID for this tool call */
+    id: string;
+    /** Name of the tool to call */
+    name: string;
+    /** Arguments for the tool */
+    arguments: Record<string, unknown>;
+}
+/**
+ * Response from LLM generation with tools
+ */
+export interface LLMResponse {
+    /** Text content of the response */
+    content: string;
+    /** Tool calls requested by the LLM */
+    toolCalls?: ToolCall[];
+    /** Whether the response is complete or needs tool results */
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'content_filter';
+    /** Token usage information */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Stream chunk from LLM
+ */
+export interface StreamChunk {
+    /** Type of the chunk */
+    type: 'content' | 'tool_call' | 'done';
+    /** Content delta (for content chunks) */
+    content?: string;
+    /** Tool call delta (for tool_call chunks) */
+    toolCall?: {
+        index: number;
+        id?: string;
+        name?: string;
+        arguments?: string;
+    };
+    /** Final response (for done chunks) */
+    response?: LLMResponse;
+}
+/**
+ * Callback for streaming chunks
+ */
+export type StreamCallback = (chunk: StreamChunk) => void;
+/**
+ * Embedding result
+ */
+export interface EmbeddingResult {
+    /** The embedding vector */
+    embedding: number[];
+    /** Token count of the input */
+    tokenCount?: number;
+}
+/**
+ * LLM Adapter Interface
+ *
+ * All LLM providers must implement this interface to be used with the Agent.
+ */
+export interface LLMAdapter {
+    /** Provider name for identification */
+    readonly provider: string;
+    /** Model name being used */
+    readonly model: string;
+    /**
+     * Generate text from a prompt
+     *
+     * @param prompt - The input prompt or conversation messages
+     * @param options - Generation options
+     * @returns Generated text
+     */
+    generate(prompt: string | ChatMessage[], options?: GenerateOptions): Promise<string>;
+    /**
+     * Generate text with tool calling support
+     *
+     * @param prompt - The input prompt or conversation messages
+     * @param tools - Available tools for the LLM to call
+     * @param options - Generation options
+     * @returns LLM response with potential tool calls
+     */
+    generateWithTools(prompt: string | ChatMessage[], tools: ToolDefinition[], options?: GenerateOptions): Promise<LLMResponse>;
+    /**
+     * Generate text with tool calling support (streaming)
+     *
+     * @param prompt - The input prompt or conversation messages
+     * @param tools - Available tools for the LLM to call
+     * @param onChunk - Callback for each streaming chunk
+     * @param options - Generation options
+     * @returns Final LLM response with potential tool calls
+     */
+    generateWithToolsStream(prompt: string | ChatMessage[], tools: ToolDefinition[], onChunk: StreamCallback, options?: GenerateOptions): Promise<LLMResponse>;
+    /**
+     * Check if the adapter supports streaming
+     */
+    supportsStreaming(): boolean;
+    /**
+     * Generate embedding for text
+     *
+     * @param text - Text to embed
+     * @returns Embedding vector
+     */
+    embed(text: string): Promise<EmbeddingResult>;
+    /**
+     * Check if the adapter supports embeddings
+     */
+    supportsEmbeddings(): boolean;
+    /**
+     * Check if the adapter supports tool calling
+     */
+    supportsToolCalling(): boolean;
+}
+/**
+ * Base configuration for creating an LLM adapter
+ */
+export interface LLMAdapterConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Model identifier */
+    model: string;
+    /** Custom API endpoint */
+    baseUrl?: string;
+    /** Default temperature */
+    temperature?: number;
+    /** Default max tokens */
+    maxTokens?: number;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * Error thrown by LLM adapters
+ */
+export declare class LLMError extends Error {
+    readonly code: LLMErrorCode;
+    readonly provider: string;
+    readonly cause?: Error;
+    constructor(message: string, code: LLMErrorCode, provider: string, cause?: Error);
+}
+/**
+ * LLM error codes
+ */
+export type LLMErrorCode = 'AUTHENTICATION_ERROR' | 'RATE_LIMIT_ERROR' | 'INVALID_REQUEST' | 'MODEL_NOT_FOUND' | 'CONTEXT_LENGTH_EXCEEDED' | 'CONTENT_FILTER' | 'TIMEOUT' | 'NETWORK_ERROR' | 'CANCELLED' | 'UNKNOWN_ERROR';
+/**
+ * Helper to convert string prompt to chat messages
+ */
+export declare function promptToMessages(prompt: string, systemPrompt?: string): ChatMessage[];
+/**
+ * Helper to extract text content from messages
+ */
+export declare function messagesToPrompt(messages: ChatMessage[]): string;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/llm/adapter.d.ts.map

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

package/dist/llm/adapter.js

@@ -0,0 +1,42 @@
+/**
+ * LLM Adapter Interface
+ *
+ * Defines the common interface for all LLM providers.
+ * Each provider (OpenAI, Claude, Qwen, etc.) implements this interface.
+ */
+/**
+ * Error thrown by LLM adapters
+ */
+export class LLMError extends Error {
+    code;
+    provider;
+    cause;
+    constructor(message, code, provider, cause) {
+        super(message);
+        this.code = code;
+        this.provider = provider;
+        this.cause = cause;
+        this.name = 'LLMError';
+    }
+}
+/**
+ * Helper to convert string prompt to chat messages
+ */
+export function promptToMessages(prompt, systemPrompt) {
+    const messages = [];
+    if (systemPrompt) {
+        messages.push({ role: 'system', content: systemPrompt });
+    }
+    messages.push({ role: 'user', content: prompt });
+    return messages;
+}
+/**
+ * Helper to extract text content from messages
+ */
+export function messagesToPrompt(messages) {
+    return messages
+        .filter((m) => m.role !== 'system')
+        .map((m) => `${m.role}: ${m.content}`)
+        .join('\n');
+}
+//# sourceMappingURL=adapter.js.map

package/dist/llm/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/llm/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmMH;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IACA;IAJlB,YACE,OAAe,EACC,IAAkB,EAClB,QAAgB,EAChB,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAc;QAClB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAiBD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,YAAqB;IACpE,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IACtD,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACrC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}