@agenticc/core 1.0.0

package/dist/knowledge/loaders/yaml.js

@@ -0,0 +1,368 @@
+/**
+ * YAML Document Loader
+ *
+ * Parses YAML configuration files and converts them to searchable text
+ * for the knowledge base. Supports MythicMobs and other game configuration formats.
+ *
+ * _Requirements: 3.1_
+ */
+/**
+ * Simple YAML parser for common configuration formats
+ * Handles basic YAML structures without external dependencies
+ */
+export function parseYaml(content) {
+    const result = {};
+    const lines = content.split(/\r?\n/);
+    // Root item has special handling
+    const stack = [];
+    let currentObj = result;
+    let lastKey = null;
+    let lastKeyIndent = -1;
+    let lastKeyParent = result;
+    let multilineValue = [];
+    let isMultiline = false;
+    let multilineIndent = 0;
+    let multilineKey = null;
+    let multilineParent = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip empty lines and comments
+        if (line.trim() === '' || line.trim().startsWith('#')) {
+            if (isMultiline) {
+                multilineValue.push('');
+            }
+            continue;
+        }
+        // Calculate indentation
+        const indent = line.search(/\S/);
+        const trimmedLine = line.trim();
+        // Handle multiline strings
+        if (isMultiline) {
+            if (indent > multilineIndent) {
+                multilineValue.push(line.slice(multilineIndent + 2));
+                continue;
+            }
+            else {
+                // End of multiline - save to the correct parent
+                if (multilineKey && multilineParent) {
+                    multilineParent[multilineKey] = multilineValue.join('\n').trim();
+                }
+                isMultiline = false;
+                multilineValue = [];
+                multilineKey = null;
+                multilineParent = null;
+            }
+        }
+        // Pop stack to correct level based on indentation
+        while (stack.length > 0 && stack[stack.length - 1].indent >= indent) {
+            stack.pop();
+        }
+        // Update currentObj based on stack
+        currentObj = stack.length > 0 ? stack[stack.length - 1].obj : result;
+        // Handle list items
+        if (trimmedLine.startsWith('- ')) {
+            const listValue = trimmedLine.slice(2).trim();
+            // Find the key for this list
+            // If we have a stack item at a lower indent, use its key
+            // Otherwise use lastKey
+            let listKey = null;
+            let listParent = result;
+            // Check if there's a stack item that should contain this list
+            for (let j = stack.length - 1; j >= 0; j--) {
+                if (stack[j].indent < indent) {
+                    listKey = stack[j].key;
+                    listParent = stack[j].parentObj;
+                    break;
+                }
+            }
+            // If no stack item found, use lastKey if it's at a lower indent
+            if (!listKey && lastKey && lastKeyIndent < indent) {
+                listKey = lastKey;
+                listParent = lastKeyParent;
+            }
+            if (listKey && listParent[listKey] !== undefined) {
+                // Convert empty object to array if needed
+                if (typeof listParent[listKey] === 'object' &&
+                    !Array.isArray(listParent[listKey]) &&
+                    Object.keys(listParent[listKey]).length === 0) {
+                    listParent[listKey] = [];
+                }
+                if (Array.isArray(listParent[listKey])) {
+                    // Check if it's a key-value pair in the list item
+                    const colonIndex = listValue.indexOf(':');
+                    if (colonIndex > 0 && !listValue.startsWith('"') && !listValue.startsWith("'")) {
+                        const itemKey = listValue.slice(0, colonIndex).trim();
+                        const itemValue = listValue.slice(colonIndex + 1).trim();
+                        const item = {};
+                        item[itemKey] = parseValue(itemValue);
+                        listParent[listKey].push(item);
+                    }
+                    else {
+                        listParent[listKey].push(parseValue(listValue));
+                    }
+                }
+            }
+            continue;
+        }
+        // Handle key-value pairs
+        const colonIndex = trimmedLine.indexOf(':');
+        if (colonIndex > 0) {
+            const key = trimmedLine.slice(0, colonIndex).trim();
+            const valueStr = trimmedLine.slice(colonIndex + 1).trim();
+            if (valueStr === '' || valueStr === '|' || valueStr === '>') {
+                // Nested object, array, or multiline string
+                if (valueStr === '|' || valueStr === '>') {
+                    isMultiline = true;
+                    multilineIndent = indent;
+                    multilineValue = [];
+                    multilineKey = key;
+                    multilineParent = currentObj;
+                }
+                else {
+                    // Could be object or array - create empty object for now
+                    currentObj[key] = {};
+                    stack.push({
+                        obj: currentObj[key],
+                        indent,
+                        key,
+                        parentObj: currentObj,
+                    });
+                }
+                lastKey = key;
+                lastKeyIndent = indent;
+                lastKeyParent = currentObj;
+            }
+            else {
+                // Simple value
+                currentObj[key] = parseValue(valueStr);
+                lastKey = key;
+                lastKeyIndent = indent;
+                lastKeyParent = currentObj;
+            }
+        }
+    }
+    // Handle any remaining multiline content
+    if (isMultiline && multilineKey && multilineParent) {
+        multilineParent[multilineKey] = multilineValue.join('\n').trim();
+    }
+    return result;
+}
+/**
+ * Parse a YAML value string to appropriate type
+ */
+function parseValue(value) {
+    // Remove quotes
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    // Boolean
+    if (value === 'true' || value === 'yes' || value === 'on')
+        return true;
+    if (value === 'false' || value === 'no' || value === 'off')
+        return false;
+    // Null
+    if (value === 'null' || value === '~' || value === '')
+        return null;
+    // Number
+    if (!isNaN(Number(value)) && value !== '') {
+        return Number(value);
+    }
+    // String
+    return value;
+}
+/**
+ * Flatten a YAML object into nodes with paths
+ */
+export function flattenYaml(data, options) {
+    const nodes = [];
+    const maxDepth = options?.maxDepth ?? 10;
+    const includeArrayIndices = options?.includeArrayIndices ?? true;
+    function traverse(obj, path, depth) {
+        // Stop if we've exceeded max depth
+        if (depth >= maxDepth)
+            return;
+        if (obj === null || obj === undefined) {
+            return;
+        }
+        if (Array.isArray(obj)) {
+            obj.forEach((item, index) => {
+                const itemPath = includeArrayIndices ? `${path}[${index}]` : path;
+                if (typeof item === 'object' && item !== null) {
+                    traverse(item, itemPath, depth + 1);
+                }
+                else {
+                    nodes.push({
+                        path: itemPath,
+                        key: `[${index}]`,
+                        value: item,
+                        depth,
+                    });
+                }
+            });
+        }
+        else if (typeof obj === 'object') {
+            for (const [key, value] of Object.entries(obj)) {
+                const newPath = path ? `${path}.${key}` : key;
+                nodes.push({
+                    path: newPath,
+                    key,
+                    value,
+                    depth,
+                });
+                if (typeof value === 'object' && value !== null) {
+                    traverse(value, newPath, depth + 1);
+                }
+            }
+        }
+    }
+    traverse(data, '', 0);
+    return nodes;
+}
+/**
+ * Convert YAML data to human-readable text
+ */
+export function yamlToText(data, indent = 0) {
+    const lines = [];
+    const prefix = '  '.repeat(indent);
+    for (const [key, value] of Object.entries(data)) {
+        if (value === null || value === undefined) {
+            lines.push(`${prefix}${key}: (empty)`);
+        }
+        else if (Array.isArray(value)) {
+            lines.push(`${prefix}${key}:`);
+            value.forEach((item, index) => {
+                if (typeof item === 'object' && item !== null) {
+                    lines.push(`${prefix}  - Item ${index + 1}:`);
+                    lines.push(yamlToText(item, indent + 2));
+                }
+                else {
+                    lines.push(`${prefix}  - ${item}`);
+                }
+            });
+        }
+        else if (typeof value === 'object') {
+            lines.push(`${prefix}${key}:`);
+            lines.push(yamlToText(value, indent + 1));
+        }
+        else {
+            lines.push(`${prefix}${key}: ${value}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Parse a YAML document and extract structured information
+ */
+export function parseYamlDocument(content, options) {
+    const data = parseYaml(content);
+    const nodes = flattenYaml(data, { maxDepth: options?.maxDepth });
+    const rootKeys = Object.keys(data);
+    const textContent = yamlToText(data);
+    return {
+        data,
+        nodes,
+        rootKeys,
+        textContent,
+    };
+}
+/**
+ * Load a YAML document as a single DocumentInput
+ */
+export function loadYamlDocument(content, options) {
+    const parsed = parseYamlDocument(content, { maxDepth: options.maxDepth });
+    // Use custom formatter or default text representation
+    const textContent = options.textFormatter
+        ? options.textFormatter(parsed.data)
+        : parsed.textContent;
+    return {
+        category: options.category,
+        title: options.title ?? `YAML Configuration (${parsed.rootKeys.join(', ')})`,
+        content: textContent,
+        metadata: {
+            ...options.metadata,
+            sourceType: 'yaml',
+            rootKeys: parsed.rootKeys,
+            nodeCount: parsed.nodes.length,
+            rawData: parsed.data,
+        },
+    };
+}
+/**
+ * Load a YAML document and split by root keys
+ */
+export function loadYamlByRootKeys(content, options) {
+    const parsed = parseYamlDocument(content, { maxDepth: options.maxDepth });
+    // If only one root key, return as single document
+    if (parsed.rootKeys.length <= 1) {
+        return [loadYamlDocument(content, options)];
+    }
+    // Create a document for each root key
+    return parsed.rootKeys.map((key) => {
+        const keyData = { [key]: parsed.data[key] };
+        const textContent = options.textFormatter
+            ? options.textFormatter(keyData)
+            : yamlToText(keyData);
+        return {
+            category: options.category,
+            title: options.title ? `${options.title} - ${key}` : key,
+            content: textContent,
+            metadata: {
+                ...options.metadata,
+                sourceType: 'yaml',
+                rootKey: key,
+                rawData: keyData,
+            },
+        };
+    });
+}
+/**
+ * YAML Loader class for loading documents into the knowledge base
+ */
+export class YamlLoader {
+    defaultCategory;
+    defaultMetadata;
+    maxDepth;
+    constructor(options) {
+        this.defaultCategory = options?.defaultCategory ?? 'config';
+        this.defaultMetadata = options?.defaultMetadata ?? {};
+        this.maxDepth = options?.maxDepth ?? 10;
+    }
+    /**
+     * Load a YAML string as a document
+     */
+    load(content, options) {
+        return loadYamlDocument(content, {
+            category: options?.category ?? this.defaultCategory,
+            title: options?.title,
+            metadata: { ...this.defaultMetadata, ...options?.metadata },
+            maxDepth: options?.maxDepth ?? this.maxDepth,
+            textFormatter: options?.textFormatter,
+        });
+    }
+    /**
+     * Load a YAML string and split by root keys
+     */
+    loadByRootKeys(content, options) {
+        return loadYamlByRootKeys(content, {
+            category: options?.category ?? this.defaultCategory,
+            title: options?.title,
+            metadata: { ...this.defaultMetadata, ...options?.metadata },
+            maxDepth: options?.maxDepth ?? this.maxDepth,
+            textFormatter: options?.textFormatter,
+        });
+    }
+    /**
+     * Parse YAML content without creating DocumentInput
+     */
+    parse(content) {
+        return parseYamlDocument(content, { maxDepth: this.maxDepth });
+    }
+    /**
+     * Parse raw YAML to object
+     */
+    parseRaw(content) {
+        return parseYaml(content);
+    }
+}
+//# sourceMappingURL=yaml.js.map

package/dist/knowledge/loaders/yaml.js.map

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

package/dist/knowledge/retriever.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Knowledge Retriever
+ *
+ * Provides advanced retrieval capabilities including keyword search,
+ * semantic search, and hybrid search with knowledge sufficiency assessment.
+ *
+ * _Requirements: 3.2, 3.3, 3.4, 5.1, 5.2_
+ */
+import type { SearchOptions, SearchResult, KnowledgeAssessment } from '../types/knowledge.js';
+import type { KnowledgeStore } from './store.js';
+import type { Embedder } from './embedder.js';
+/**
+ * Retriever configuration
+ */
+export interface RetrieverConfig {
+    /** Default number of results to return */
+    defaultTopK?: number;
+    /** Default minimum score threshold */
+    defaultMinScore?: number;
+    /** Weight for keyword search in hybrid mode (0-1) */
+    keywordWeight?: number;
+    /** Weight for semantic search in hybrid mode (0-1) */
+    semanticWeight?: number;
+    /** Minimum confidence threshold for sufficient knowledge */
+    sufficientThreshold?: number;
+    /** Minimum confidence threshold for ambiguous knowledge */
+    ambiguousThreshold?: number;
+}
+/**
+ * Intent information for knowledge assessment
+ */
+export interface Intent {
+    /** The main action or query type */
+    action: string;
+    /** Key entities mentioned */
+    entities: string[];
+    /** Required knowledge topics */
+    requiredTopics?: string[];
+}
+/**
+ * Knowledge Retriever class
+ *
+ * Provides keyword, semantic, and hybrid search capabilities
+ * with knowledge sufficiency assessment.
+ */
+export declare class Retriever {
+    private store;
+    private embedder?;
+    private config;
+    constructor(store: KnowledgeStore, embedder?: Embedder, config?: RetrieverConfig);
+    /**
+     * Search the knowledge base
+     *
+     * @param query - Search query string
+     * @param options - Search options
+     * @returns Array of search results sorted by relevance
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Keyword-based search using text matching
+     *
+     * Implements simple keyword matching with term frequency scoring.
+     * Supports category filtering.
+     *
+     * _Requirements: 3.4_
+     *
+     * @param query - Search query
+     * @param category - Optional category filter
+     * @returns Search results sorted by score descending
+     */
+    keywordSearch(query: string, category?: string): Promise<SearchResult[]>;
+    /**
+     * Perform keyword matching on documents
+     */
+    private performKeywordMatch;
+    /**
+     * Semantic search using embedding similarity
+     *
+     * Uses vector similarity to find semantically related documents.
+     * Falls back to keyword search if embedder is not available.
+     *
+     * _Requirements: 3.3_
+     *
+     * @param query - Search query
+     * @param category - Optional category filter
+     * @returns Search results sorted by score descending
+     */
+    semanticSearch(query: string, category?: string): Promise<SearchResult[]>;
+    /**
+     * Perform semantic matching on documents
+     */
+    private performSemanticMatch;
+    /**
+     * Hybrid search combining keyword and semantic results
+     *
+     * Merges results from both methods with configurable weights.
+     * Deduplicates and re-ranks results.
+     *
+     * _Requirements: 3.2_
+     *
+     * @param query - Search query
+     * @param category - Optional category filter
+     * @returns Search results sorted by combined score descending
+     */
+    hybridSearch(query: string, category?: string): Promise<SearchResult[]>;
+    /**
+     * Assess knowledge sufficiency for a given intent
+     *
+     * Evaluates whether the retrieved knowledge is sufficient
+     * to answer the user's query.
+     *
+     * _Requirements: 5.1, 5.2_
+     *
+     * @param results - Search results to assess
+     * @param intent - User intent information
+     * @returns Knowledge assessment with status and confidence
+     */
+    assessKnowledge(results: SearchResult[], intent: Intent): KnowledgeAssessment;
+    /**
+     * Find topics covered by search results
+     */
+    private findCoveredTopics;
+    /**
+     * Tokenize text into search terms
+     */
+    private tokenize;
+    /**
+     * Escape special regex characters
+     */
+    private escapeRegex;
+    /**
+     * Convert score to confidence level
+     */
+    private scoreToConfidence;
+    /**
+     * Get retriever configuration
+     */
+    getConfig(): Required<RetrieverConfig>;
+    /**
+     * Update retriever configuration
+     */
+    updateConfig(config: Partial<RetrieverConfig>): void;
+}
+//# sourceMappingURL=retriever.d.ts.map

package/dist/knowledge/retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriever.d.ts","sourceRoot":"","sources":["../../src/knowledge/retriever.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAWD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAoBD;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,MAAM,CAA4B;gBAE9B,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,eAAe;IAMhF;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0B7E;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAc9E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmE3B;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA6B/E;;OAEG;YACW,oBAAoB;IAyClC;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA+C7E;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB;IA0E7E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC;IAItC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAGrD"}