@cogitator-ai/neuro-symbolic 0.1.0

package/dist/knowledge-graph/natural-language-query.js

@@ -0,0 +1,271 @@
+import { executeQuery, GraphQueryBuilder, variable } from './query-language';
+export function analyzeNLQuery(question) {
+    const lower = question.toLowerCase();
+    const analysis = {
+        intent: 'find',
+        entities: [],
+        relations: [],
+        constraints: [],
+        variables: [],
+    };
+    if (lower.startsWith('is ') ||
+        lower.startsWith('are ') ||
+        lower.startsWith('does ') ||
+        lower.startsWith('do ')) {
+        analysis.intent = 'check';
+    }
+    else if (lower.startsWith('how many') || lower.includes('count')) {
+        analysis.intent = 'count';
+    }
+    else if (lower.startsWith('what is') ||
+        lower.startsWith('describe') ||
+        lower.startsWith('tell me about')) {
+        analysis.intent = 'describe';
+    }
+    else if (lower.includes('compare') || lower.includes('difference between')) {
+        analysis.intent = 'compare';
+    }
+    const quotedPattern = /"([^"]+)"/g;
+    let match;
+    while ((match = quotedPattern.exec(question)) !== null) {
+        analysis.entities.push(match[1]);
+    }
+    const capitalizedPattern = /\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)\b/g;
+    while ((match = capitalizedPattern.exec(question)) !== null) {
+        const word = match[1];
+        if (!['Who', 'What', 'Where', 'When', 'How', 'Why', 'Is', 'Are', 'Does', 'Do'].includes(word)) {
+            analysis.entities.push(word);
+        }
+    }
+    const relationKeywords = [
+        'works at',
+        'works for',
+        'employed by',
+        'knows',
+        'friends with',
+        'related to',
+        'located in',
+        'lives in',
+        'based in',
+        'part of',
+        'belongs to',
+        'member of',
+        'created by',
+        'made by',
+        'built by',
+        'connected to',
+        'linked to',
+        'associated with',
+    ];
+    for (const keyword of relationKeywords) {
+        if (lower.includes(keyword)) {
+            analysis.relations.push(keyword.replace(/\s+/g, '_'));
+        }
+    }
+    if (lower.includes('who')) {
+        analysis.variables.push('person');
+    }
+    if (lower.includes('what')) {
+        analysis.variables.push('thing');
+    }
+    if (lower.includes('where')) {
+        analysis.variables.push('location');
+    }
+    if (lower.includes('when')) {
+        analysis.variables.push('time');
+    }
+    return analysis;
+}
+export function buildQueryFromAnalysis(analysis) {
+    const builder = analysis.intent === 'check' ? GraphQueryBuilder.ask() : GraphQueryBuilder.select();
+    if (analysis.intent === 'count') {
+        builder.count('X', 'count');
+    }
+    if (analysis.entities.length >= 2 && analysis.relations.length > 0) {
+        builder.where(analysis.entities[0], analysis.relations[0], analysis.entities[1]);
+    }
+    else if (analysis.entities.length === 1 && analysis.relations.length > 0) {
+        builder.where(variable('X'), analysis.relations[0], analysis.entities[0]);
+    }
+    else if (analysis.entities.length === 1) {
+        builder.where(variable('X'), variable('relation'), analysis.entities[0]);
+        builder.where(analysis.entities[0], variable('relation2'), variable('Y'));
+    }
+    else if (analysis.variables.length > 0) {
+        builder.where(variable('X'), variable('relation'), variable('Y'));
+    }
+    if (analysis.intent !== 'count') {
+        builder.limit(20);
+    }
+    return builder.build();
+}
+export function createNLToGraphQueryPrompt(ctx) {
+    return `You are a knowledge graph query expert. Convert the natural language question into a structured graph query.
+
+Available entity types: ${ctx.availableEntityTypes.join(', ')}
+Available relation types: ${ctx.availableRelationTypes.join(', ')}
+${ctx.sampleEntities ? `Sample entities: ${ctx.sampleEntities.slice(0, 10).join(', ')}` : ''}
+${ctx.sampleRelations ? `Sample relations: ${ctx.sampleRelations.slice(0, 10).join(', ')}` : ''}
+
+Question: "${ctx.question}"
+
+Respond with a JSON object containing:
+{
+  "type": "select" | "ask" | "count",
+  "patterns": [
+    {
+      "subject": "entity name or ?variable",
+      "predicate": "relation type",
+      "object": "entity name or ?variable"
+    }
+  ],
+  "filters": [
+    {
+      "field": "variable.property",
+      "operator": "eq" | "contains" | "gt" | "lt",
+      "value": "the value"
+    }
+  ],
+  "limit": number
+}
+
+Query JSON:`;
+}
+export function parseNLQueryResponse(response) {
+    try {
+        const jsonMatch = /\{[\s\S]*\}/.exec(response);
+        if (!jsonMatch)
+            return null;
+        const parsed = JSON.parse(jsonMatch[0]);
+        const query = {
+            type: parsed.type || 'select',
+            patterns: [],
+        };
+        if (Array.isArray(parsed.patterns)) {
+            for (const p of parsed.patterns) {
+                query.patterns.push({
+                    subject: p.subject?.startsWith('?') ? { name: p.subject.substring(1) } : p.subject,
+                    predicate: p.predicate?.startsWith('?')
+                        ? { name: p.predicate.substring(1) }
+                        : p.predicate,
+                    object: p.object?.startsWith('?') ? { name: p.object.substring(1) } : p.object,
+                });
+            }
+        }
+        if (Array.isArray(parsed.filters)) {
+            query.filters = parsed.filters;
+        }
+        if (parsed.limit) {
+            query.limit = parsed.limit;
+        }
+        if (parsed.orderBy) {
+            query.orderBy = parsed.orderBy;
+        }
+        return query;
+    }
+    catch {
+        return null;
+    }
+}
+export async function executeNLQuery(question, ctx) {
+    const analysis = analyzeNLQuery(question);
+    const query = buildQueryFromAnalysis(analysis);
+    const result = await executeQuery(query, {
+        adapter: ctx.adapter,
+        agentId: ctx.agentId,
+        variables: new Map(),
+    });
+    const naturalLanguageResponse = formatResultAsNaturalLanguage(question, analysis, result);
+    const confidence = calculateConfidence(analysis, result);
+    return {
+        query,
+        results: result,
+        naturalLanguageResponse,
+        confidence,
+    };
+}
+function formatResultAsNaturalLanguage(question, analysis, result) {
+    if (result.count === 0) {
+        return `I couldn't find any information to answer: "${question}"`;
+    }
+    if (analysis.intent === 'check') {
+        return result.count > 0 ? 'Yes.' : 'No.';
+    }
+    if (analysis.intent === 'count') {
+        const countValue = result.bindings[0]?.count;
+        return `The count is ${countValue}.`;
+    }
+    const responses = [];
+    for (const binding of result.bindings.slice(0, 5)) {
+        const parts = [];
+        for (const [key, value] of Object.entries(binding)) {
+            if (typeof value === 'object' && value !== null && 'name' in value) {
+                parts.push(`${key}: ${value.name}`);
+            }
+            else if (typeof value === 'object' && value !== null && 'type' in value) {
+                const edge = value;
+                parts.push(`${key}: ${edge.label || edge.type}`);
+            }
+            else {
+                parts.push(`${key}: ${value}`);
+            }
+        }
+        responses.push(parts.join(', '));
+    }
+    if (result.count > 5) {
+        responses.push(`... and ${result.count - 5} more results.`);
+    }
+    return responses.join('\n');
+}
+function calculateConfidence(analysis, result) {
+    let confidence = 0.5;
+    if (analysis.entities.length > 0) {
+        confidence += 0.2;
+    }
+    if (analysis.relations.length > 0) {
+        confidence += 0.2;
+    }
+    if (result.count > 0) {
+        confidence += 0.1;
+    }
+    if (result.count > 10) {
+        confidence -= 0.1;
+    }
+    return Math.max(0, Math.min(1, confidence));
+}
+export function suggestQuestions(nodes, edges) {
+    const suggestions = [];
+    const entityTypes = new Set(nodes.map((n) => n.type));
+    const relationTypes = new Set(edges.map((e) => e.type));
+    for (const type of entityTypes) {
+        suggestions.push(`What ${type}s are in the graph?`);
+    }
+    for (const relType of relationTypes) {
+        suggestions.push(`Who ${relType.replace(/_/g, ' ')} whom?`);
+    }
+    if (nodes.length > 0) {
+        const sampleNode = nodes[0];
+        suggestions.push(`Tell me about ${sampleNode.name}`);
+        suggestions.push(`What is connected to ${sampleNode.name}?`);
+    }
+    return suggestions.slice(0, 10);
+}
+export function generateClarifications(_question, analysis, availableEntities, availableRelations) {
+    const clarifications = [];
+    if (analysis.entities.length === 0 && analysis.variables.length === 0) {
+        clarifications.push({
+            type: 'ambiguous_entity',
+            message: "I'm not sure what entity you're asking about. Could you specify?",
+            options: availableEntities.slice(0, 5),
+        });
+    }
+    if (analysis.relations.length === 0 && analysis.intent !== 'describe') {
+        clarifications.push({
+            type: 'missing_relation',
+            message: 'What relationship are you interested in?',
+            options: availableRelations.slice(0, 5),
+        });
+    }
+    return clarifications;
+}
+//# sourceMappingURL=natural-language-query.js.map

package/dist/knowledge-graph/natural-language-query.js.map

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

package/dist/knowledge-graph/prompts.d.ts

@@ -0,0 +1,56 @@
+import type { GraphNode, GraphEdge, GraphPath, GraphQuery, GraphQueryResult, EntityType, RelationType } from '@cogitator-ai/types';
+export interface GraphContextForPrompt {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    question?: string;
+}
+export declare function createGraphContextPrompt(ctx: GraphContextForPrompt): string;
+export interface QueryToNLContext {
+    query: GraphQuery;
+    result: GraphQueryResult;
+}
+export declare function createQueryExplanationPrompt(ctx: QueryToNLContext): string;
+export interface PathExplanationContext {
+    path: GraphPath;
+    question?: string;
+}
+export declare function createPathExplanationPrompt(ctx: PathExplanationContext): string;
+export interface EntityExtractionContext {
+    text: string;
+    existingTypes?: EntityType[];
+    existingRelations?: RelationType[];
+}
+export declare function createEntityExtractionPrompt(ctx: EntityExtractionContext): string;
+export interface ReasoningExplanationContext {
+    startNode: string;
+    endNode: string;
+    paths: GraphPath[];
+    question?: string;
+}
+export declare function createReasoningExplanationPrompt(ctx: ReasoningExplanationContext): string;
+export interface GraphSummaryContext {
+    nodeCount: number;
+    edgeCount: number;
+    nodesByType: Record<string, number>;
+    edgesByType: Record<string, number>;
+    topNodes: GraphNode[];
+}
+export declare function createGraphSummaryPrompt(ctx: GraphSummaryContext): string;
+export declare function parseEntityExtractionResponse(response: string): {
+    entities: Array<{
+        name: string;
+        type: EntityType;
+        description?: string;
+        confidence: number;
+    }>;
+    relations: Array<{
+        source: string;
+        target: string;
+        type: RelationType;
+        confidence: number;
+    }>;
+} | null;
+export declare function formatNodeForPrompt(node: GraphNode): string;
+export declare function formatEdgeForPrompt(edge: GraphEdge, sourceNode?: GraphNode, targetNode?: GraphNode): string;
+export declare function formatPathForPrompt(path: GraphPath): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/knowledge-graph/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAsB3E;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAoB1E;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAqB/E;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7B,iBAAiB,CAAC,EAAE,YAAY,EAAE,CAAC;CACpC;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAsCjF;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,2BAA2B,GAAG,MAAM,CAwBzF;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CA2BzE;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/D,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,UAAU,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,SAAS,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,YAAY,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ,GAAG,IAAI,CAwBP;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAM3D;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,UAAU,CAAC,EAAE,SAAS,EACtB,UAAU,CAAC,EAAE,SAAS,GACrB,MAAM,CAMR;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAgB3D"}

package/dist/knowledge-graph/prompts.js

@@ -0,0 +1,198 @@
+export function createGraphContextPrompt(ctx) {
+    const nodeDescriptions = ctx.nodes
+        .map((n) => `- ${n.name} (${n.type}): ${n.description || 'No description'}`)
+        .join('\n');
+    const edgeDescriptions = ctx.edges
+        .map((e) => {
+        const sourceNode = ctx.nodes.find((n) => n.id === e.sourceNodeId);
+        const targetNode = ctx.nodes.find((n) => n.id === e.targetNodeId);
+        return `- ${sourceNode?.name || e.sourceNodeId} --[${e.label || e.type}]--> ${targetNode?.name || e.targetNodeId}`;
+    })
+        .join('\n');
+    return `Knowledge Graph Context:
+
+Entities:
+${nodeDescriptions || 'No entities.'}
+
+Relationships:
+${edgeDescriptions || 'No relationships.'}
+
+${ctx.question ? `\nQuestion: ${ctx.question}` : ''}`;
+}
+export function createQueryExplanationPrompt(ctx) {
+    const patterns = ctx.query.patterns
+        .map((p) => {
+        const subj = typeof p.subject === 'string' ? p.subject : `?${p.subject?.name}`;
+        const pred = typeof p.predicate === 'string' ? p.predicate : `?${p.predicate?.name}`;
+        const obj = typeof p.object === 'string' ? p.object : `?${p.object?.name}`;
+        return `  (${subj}, ${pred}, ${obj})`;
+    })
+        .join('\n');
+    return `Explain the following graph query results in natural language.
+
+Query type: ${ctx.query.type}
+Patterns:
+${patterns}
+
+Number of results: ${ctx.result.count}
+Execution time: ${ctx.result.executionTime}ms
+
+Provide a clear, concise explanation of what was queried and what was found.`;
+}
+export function createPathExplanationPrompt(ctx) {
+    const steps = [];
+    for (let i = 0; i < ctx.path.edges.length; i++) {
+        const edge = ctx.path.edges[i];
+        const fromNode = ctx.path.nodes[i];
+        const toNode = ctx.path.nodes[i + 1];
+        steps.push(`${i + 1}. ${fromNode.name} --[${edge.label || edge.type}]--> ${toNode.name}`);
+    }
+    return `Explain the following path through a knowledge graph:
+
+Path (${ctx.path.length} steps):
+${steps.join('\n')}
+
+Total weight: ${ctx.path.totalWeight.toFixed(3)}
+
+${ctx.question ? `Original question: ${ctx.question}` : ''}
+
+Provide a natural language explanation of how these entities are connected.`;
+}
+export function createEntityExtractionPrompt(ctx) {
+    const typesList = ctx.existingTypes?.length
+        ? `Available entity types: ${ctx.existingTypes.join(', ')}`
+        : 'Entity types: person, organization, location, concept, event, object';
+    const relationsList = ctx.existingRelations?.length
+        ? `Available relation types: ${ctx.existingRelations.join(', ')}`
+        : 'Relation types: knows, works_at, located_in, part_of, related_to, created_by, belongs_to, associated_with';
+    return `Extract entities and relationships from the following text.
+
+${typesList}
+${relationsList}
+
+Text:
+"${ctx.text}"
+
+Respond with a JSON object:
+{
+  "entities": [
+    {
+      "name": "Entity Name",
+      "type": "entity_type",
+      "description": "Brief description",
+      "confidence": 0.0-1.0
+    }
+  ],
+  "relations": [
+    {
+      "source": "Source Entity Name",
+      "target": "Target Entity Name",
+      "type": "relation_type",
+      "confidence": 0.0-1.0
+    }
+  ]
+}
+
+JSON:`;
+}
+export function createReasoningExplanationPrompt(ctx) {
+    const pathDescriptions = ctx.paths
+        .map((path, i) => {
+        const steps = [];
+        for (let j = 0; j < path.edges.length; j++) {
+            const edge = path.edges[j];
+            const fromNode = path.nodes[j];
+            const toNode = path.nodes[j + 1];
+            steps.push(`${fromNode.name} --[${edge.label || edge.type}]--> ${toNode.name}`);
+        }
+        return `Path ${i + 1} (confidence: ${(path.totalWeight * 100).toFixed(1)}%):\n  ${steps.join(' → ')}`;
+    })
+        .join('\n\n');
+    return `Explain the reasoning paths between two entities in the knowledge graph.
+
+From: ${ctx.startNode}
+To: ${ctx.endNode}
+
+${ctx.paths.length > 0 ? `Found ${ctx.paths.length} path(s):\n\n${pathDescriptions}` : 'No paths found.'}
+
+${ctx.question ? `Question: ${ctx.question}` : ''}
+
+Explain how these entities are connected and what the relationships mean.`;
+}
+export function createGraphSummaryPrompt(ctx) {
+    const nodeTypeSummary = Object.entries(ctx.nodesByType)
+        .map(([type, count]) => `  - ${type}: ${count}`)
+        .join('\n');
+    const edgeTypeSummary = Object.entries(ctx.edgesByType)
+        .map(([type, count]) => `  - ${type}: ${count}`)
+        .join('\n');
+    const topNodesSummary = ctx.topNodes.map((n) => `  - ${n.name} (${n.type})`).join('\n');
+    return `Summarize the following knowledge graph in natural language.
+
+Statistics:
+- Total entities: ${ctx.nodeCount}
+- Total relationships: ${ctx.edgeCount}
+
+Entities by type:
+${nodeTypeSummary}
+
+Relationships by type:
+${edgeTypeSummary}
+
+Most connected entities:
+${topNodesSummary}
+
+Provide a concise summary of what this knowledge graph contains.`;
+}
+export function parseEntityExtractionResponse(response) {
+    try {
+        const jsonMatch = /\{[\s\S]*\}/.exec(response);
+        if (!jsonMatch)
+            return null;
+        const parsed = JSON.parse(jsonMatch[0]);
+        return {
+            entities: (parsed.entities || []).map((e) => ({
+                name: String(e.name || ''),
+                type: e.type || 'custom',
+                description: e.description ? String(e.description) : undefined,
+                confidence: typeof e.confidence === 'number' ? e.confidence : 0.5,
+            })),
+            relations: (parsed.relations || []).map((r) => ({
+                source: String(r.source || ''),
+                target: String(r.target || ''),
+                type: r.type || 'related_to',
+                confidence: typeof r.confidence === 'number' ? r.confidence : 0.5,
+            })),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function formatNodeForPrompt(node) {
+    const props = Object.entries(node.properties)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join(', ');
+    return `${node.name} (${node.type})${node.description ? `: ${node.description}` : ''}${props ? ` [${props}]` : ''}`;
+}
+export function formatEdgeForPrompt(edge, sourceNode, targetNode) {
+    const source = sourceNode?.name || edge.sourceNodeId;
+    const target = targetNode?.name || edge.targetNodeId;
+    const label = edge.label || edge.type;
+    return `${source} --[${label}]--> ${target}`;
+}
+export function formatPathForPrompt(path) {
+    const steps = [];
+    for (let i = 0; i < path.edges.length; i++) {
+        const edge = path.edges[i];
+        const fromNode = path.nodes[i];
+        const toNode = path.nodes[i + 1];
+        if (i === 0) {
+            steps.push(fromNode.name);
+        }
+        steps.push(`--[${edge.label || edge.type}]-->`);
+        steps.push(toNode.name);
+    }
+    return steps.join(' ');
+}
+//# sourceMappingURL=prompts.js.map

package/dist/knowledge-graph/prompts.js.map

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

package/dist/knowledge-graph/query-language.d.ts

@@ -0,0 +1,43 @@
+import type { GraphQuery, GraphQueryResult, QueryPattern, QueryCondition, QueryVariable, QueryOperator, GraphAdapter } from '@cogitator-ai/types';
+export interface QueryExecutionContext {
+    adapter: GraphAdapter;
+    agentId: string;
+    variables: Map<string, unknown>;
+    timeout?: number;
+}
+export interface ParsedPattern {
+    subjectVar: string | null;
+    subjectValue: string | null;
+    predicateVar: string | null;
+    predicateValue: string | null;
+    objectVar: string | null;
+    objectValue: string | null;
+    conditions: QueryCondition[];
+}
+export declare function executeQuery(query: GraphQuery, ctx: QueryExecutionContext): Promise<GraphQueryResult>;
+export declare class GraphQueryBuilder {
+    private query;
+    constructor(type?: GraphQuery['type']);
+    static select(): GraphQueryBuilder;
+    static ask(): GraphQueryBuilder;
+    static construct(): GraphQueryBuilder;
+    static describe(): GraphQueryBuilder;
+    where(subject: string | QueryVariable, predicate: string | QueryVariable, object: string | QueryVariable): this;
+    pattern(pattern: QueryPattern): this;
+    filter(field: string, operator: QueryOperator, value: unknown): this;
+    orderBy(field: string, direction?: 'asc' | 'desc'): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    count(field: string, alias: string): this;
+    sum(field: string, alias: string): this;
+    avg(field: string, alias: string): this;
+    min(field: string, alias: string): this;
+    max(field: string, alias: string): this;
+    groupBy(...fields: string[]): this;
+    build(): GraphQuery;
+    execute(ctx: QueryExecutionContext): Promise<GraphQueryResult>;
+}
+export declare function variable(name: string, type?: 'node' | 'edge' | 'value'): QueryVariable;
+export declare function parseQueryString(queryString: string): GraphQuery;
+export declare function formatQueryResult(result: GraphQueryResult): string;
+//# sourceMappingURL=query-language.d.ts.map

package/dist/knowledge-graph/query-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-language.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/query-language.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAEd,aAAa,EACb,aAAa,EAIb,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AA0XD,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAqC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAa;gBAEd,IAAI,GAAE,UAAU,CAAC,MAAM,CAAY;IAO/C,MAAM,CAAC,MAAM,IAAI,iBAAiB;IAIlC,MAAM,CAAC,GAAG,IAAI,iBAAiB;IAI/B,MAAM,CAAC,SAAS,IAAI,iBAAiB;IAIrC,MAAM,CAAC,QAAQ,IAAI,iBAAiB;IAIpC,KAAK,CACH,OAAO,EAAE,MAAM,GAAG,aAAa,EAC/B,SAAS,EAAE,MAAM,GAAG,aAAa,EACjC,MAAM,EAAE,MAAM,GAAG,aAAa,GAC7B,IAAI;IAKP,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAKpC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAQpE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAQ/D,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQzC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQvC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQvC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQvC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQvC,OAAO,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAKlC,KAAK,IAAI,UAAU;IAIb,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGrE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAEtF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CA8DhE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyClE"}