@agenticc/core 1.0.0

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Core Module
+ *
+ * Contains the core components of the Agent system including
+ * tool registry, tool executor, intent parser, plan generator,
+ * response handler, and the main Agent class.
+ */
+export * from './tool-registry.js';
+export * from './tool-executor.js';
+export * from './intent-parser.js';
+export * from './plan-generator.js';
+export * from './response-handler.js';
+export * from './agent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,14 @@
+/**
+ * Core Module
+ *
+ * Contains the core components of the Agent system including
+ * tool registry, tool executor, intent parser, plan generator,
+ * response handler, and the main Agent class.
+ */
+export * from './tool-registry.js';
+export * from './tool-executor.js';
+export * from './intent-parser.js';
+export * from './plan-generator.js';
+export * from './response-handler.js';
+export * from './agent.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/core/intent-parser.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Intent Parser
+ *
+ * Parses user messages to extract intent, entities, and operation type.
+ * Uses LLM to understand natural language and determine appropriate actions.
+ *
+ * _Requirements: 1.1_
+ */
+import type { LLMManager } from '../llm/manager.js';
+import type { ChatMessage } from '../llm/adapter.js';
+/**
+ * Parsed intent from user message
+ */
+export interface Intent {
+    /** The main action or operation type */
+    action: string;
+    /** Key entities mentioned in the message */
+    entities: string[];
+    /** Required knowledge topics to fulfill the intent */
+    requiredTopics?: string[];
+    /** Confidence level of the parsing */
+    confidence: number;
+    /** Original user message */
+    originalMessage: string;
+    /** Additional context extracted from the message */
+    context?: Record<string, unknown>;
+}
+/**
+ * Operation types that the agent can perform
+ */
+export type OperationType = 'query' | 'create' | 'update' | 'delete' | 'execute' | 'configure' | 'unknown';
+/**
+ * Detailed intent with operation classification
+ */
+export interface DetailedIntent extends Intent {
+    /** Classified operation type */
+    operationType: OperationType;
+    /** Target resource or entity */
+    target?: string;
+    /** Parameters extracted from the message */
+    parameters?: Record<string, unknown>;
+}
+/**
+ * Intent parser configuration
+ */
+export interface IntentParserConfig {
+    /** System prompt for intent parsing */
+    systemPrompt?: string;
+    /** Whether to include conversation history */
+    includeHistory?: boolean;
+    /** Maximum history messages to include */
+    maxHistoryMessages?: number;
+}
+/**
+ * Intent Parser
+ *
+ * Uses LLM to parse user messages and extract structured intent information.
+ */
+export declare class IntentParser {
+    private llmManager;
+    private config;
+    constructor(llmManager: LLMManager, config?: IntentParserConfig);
+    /**
+     * Parse a user message to extract intent
+     *
+     * @param message - User message to parse
+     * @param history - Optional conversation history
+     * @returns Parsed intent
+     */
+    parse(message: string, _history?: ChatMessage[]): Promise<DetailedIntent>;
+    /**
+     * Build messages for LLM call
+     */
+    private buildMessages;
+    /**
+     * Parse LLM response into DetailedIntent
+     */
+    private parseResponse;
+    /**
+     * Validate and normalize operation type
+     */
+    private validateOperationType;
+    /**
+     * Create a fallback intent when parsing fails
+     */
+    private createFallbackIntent;
+    /**
+     * Extract entities from a message using simple pattern matching
+     * Used as a supplement to LLM parsing
+     */
+    extractEntities(message: string): string[];
+    /**
+     * Update the system prompt
+     */
+    setSystemPrompt(prompt: string): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Required<IntentParserConfig>;
+}
+//# sourceMappingURL=intent-parser.d.ts.map

package/dist/core/intent-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-parser.d.ts","sourceRoot":"","sources":["../../src/core/intent-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,WAAW,GACX,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,gCAAgC;IAChC,aAAa,EAAE,aAAa,CAAC;IAC7B,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAkCD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAA+B;gBAEjC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,kBAAkB;IAS/D;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAM/E;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyE5B;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAkB1C;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,kBAAkB,CAAC;CAG1C"}

package/dist/core/intent-parser.js

@@ -0,0 +1,221 @@
+/**
+ * Intent Parser
+ *
+ * Parses user messages to extract intent, entities, and operation type.
+ * Uses LLM to understand natural language and determine appropriate actions.
+ *
+ * _Requirements: 1.1_
+ */
+const DEFAULT_SYSTEM_PROMPT = `你是一个游戏服务器管理系统的意图解析器。
+你的任务是分析用户消息并提取结构化信息。
+
+【重要】你必须且只能返回一个 JSON 对象，不要包含任何其他文字或解释。
+
+JSON 格式如下：
+{
+  "action": "用户想要执行的主要操作描述",
+  "entities": ["提到的实体名称数组，如怪物名、Boss名、玩家名等"],
+  "requiredTopics": ["需要的知识主题数组"],
+  "operationType": "query|create|update|delete|execute|configure|unknown",
+  "target": "目标资源（可选）",
+  "parameters": {},
+  "confidence": 0.8
+}
+
+operationType 说明：
+- query: 查询信息
+- create: 创建新资源
+- update: 修改现有资源
+- delete: 删除资源
+- execute: 执行操作
+- configure: 配置设置
+- unknown: 无法确定（如简单问候）
+
+示例：
+用户: "你好"
+返回: {"action":"问候","entities":[],"requiredTopics":[],"operationType":"unknown","confidence":0.9}
+
+用户: "查看所有Boss"
+返回: {"action":"查询Boss列表","entities":["Boss"],"requiredTopics":["boss"],"operationType":"query","target":"boss","confidence":0.95}`;
+/**
+ * Intent Parser
+ *
+ * Uses LLM to parse user messages and extract structured intent information.
+ */
+export class IntentParser {
+    llmManager;
+    config;
+    constructor(llmManager, config) {
+        this.llmManager = llmManager;
+        this.config = {
+            systemPrompt: config?.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+            includeHistory: config?.includeHistory ?? true,
+            maxHistoryMessages: config?.maxHistoryMessages ?? 5,
+        };
+    }
+    /**
+     * Parse a user message to extract intent
+     *
+     * @param message - User message to parse
+     * @param history - Optional conversation history
+     * @returns Parsed intent
+     */
+    async parse(message, _history) {
+        // Skip LLM call for intent parsing - use keyword-based fallback directly
+        // This is more reliable for Chinese language models that don't follow JSON format
+        return this.createFallbackIntent(message);
+    }
+    /**
+     * Build messages for LLM call
+     */
+    buildMessages(message, history) {
+        const messages = [{ role: 'system', content: this.config.systemPrompt }];
+        // Add conversation history if enabled
+        if (this.config.includeHistory && history && history.length > 0) {
+            const recentHistory = history.slice(-this.config.maxHistoryMessages);
+            messages.push(...recentHistory);
+        }
+        // Add current user message
+        messages.push({ role: 'user', content: message });
+        return messages;
+    }
+    /**
+     * Parse LLM response into DetailedIntent
+     */
+    parseResponse(response, originalMessage) {
+        try {
+            // Extract JSON from response (handle markdown code blocks)
+            const jsonMatch = response.match(/```(?:json)?\s*([\s\S]*?)```/) || response.match(/\{[\s\S]*\}/);
+            const jsonStr = jsonMatch ? (jsonMatch[1] || jsonMatch[0]).trim() : response.trim();
+            const parsed = JSON.parse(jsonStr);
+            return {
+                action: parsed.action || 'unknown',
+                entities: Array.isArray(parsed.entities) ? parsed.entities : [],
+                requiredTopics: Array.isArray(parsed.requiredTopics) ? parsed.requiredTopics : [],
+                confidence: typeof parsed.confidence === 'number' ? Math.max(0, Math.min(1, parsed.confidence)) : 0.5,
+                originalMessage,
+                operationType: this.validateOperationType(parsed.operationType),
+                target: parsed.target,
+                parameters: typeof parsed.parameters === 'object' ? parsed.parameters : undefined,
+                context: parsed.context,
+            };
+        }
+        catch (error) {
+            console.warn('Failed to parse intent response:', error);
+            return this.createFallbackIntent(originalMessage);
+        }
+    }
+    /**
+     * Validate and normalize operation type
+     */
+    validateOperationType(type) {
+        const validTypes = [
+            'query',
+            'create',
+            'update',
+            'delete',
+            'execute',
+            'configure',
+            'unknown',
+        ];
+        if (typeof type === 'string' && validTypes.includes(type)) {
+            return type;
+        }
+        return 'unknown';
+    }
+    /**
+     * Create a fallback intent when parsing fails
+     */
+    createFallbackIntent(message) {
+        // Simple heuristic-based fallback
+        const lowerMessage = message.toLowerCase();
+        let operationType = 'unknown';
+        const entities = [];
+        // Detect operation type from keywords
+        if (lowerMessage.includes('查询') ||
+            lowerMessage.includes('获取') ||
+            lowerMessage.includes('查看') ||
+            lowerMessage.includes('显示') ||
+            lowerMessage.includes('what') ||
+            lowerMessage.includes('show') ||
+            lowerMessage.includes('get') ||
+            lowerMessage.includes('list')) {
+            operationType = 'query';
+        }
+        else if (lowerMessage.includes('创建') ||
+            lowerMessage.includes('新建') ||
+            lowerMessage.includes('添加') ||
+            lowerMessage.includes('create') ||
+            lowerMessage.includes('add') ||
+            lowerMessage.includes('new')) {
+            operationType = 'create';
+        }
+        else if (lowerMessage.includes('修改') ||
+            lowerMessage.includes('更新') ||
+            lowerMessage.includes('编辑') ||
+            lowerMessage.includes('update') ||
+            lowerMessage.includes('modify') ||
+            lowerMessage.includes('edit')) {
+            operationType = 'update';
+        }
+        else if (lowerMessage.includes('删除') ||
+            lowerMessage.includes('移除') ||
+            lowerMessage.includes('delete') ||
+            lowerMessage.includes('remove')) {
+            operationType = 'delete';
+        }
+        else if (lowerMessage.includes('执行') ||
+            lowerMessage.includes('运行') ||
+            lowerMessage.includes('execute') ||
+            lowerMessage.includes('run')) {
+            operationType = 'execute';
+        }
+        else if (lowerMessage.includes('配置') ||
+            lowerMessage.includes('设置') ||
+            lowerMessage.includes('configure') ||
+            lowerMessage.includes('set')) {
+            operationType = 'configure';
+        }
+        // Higher confidence if we detected a known operation type
+        const confidence = operationType !== 'unknown' ? 0.6 : 0.3;
+        return {
+            action: message.slice(0, 100), // Use first 100 chars as action
+            entities,
+            requiredTopics: [],
+            confidence,
+            originalMessage: message,
+            operationType,
+        };
+    }
+    /**
+     * Extract entities from a message using simple pattern matching
+     * Used as a supplement to LLM parsing
+     */
+    extractEntities(message) {
+        const entities = [];
+        // Extract quoted strings
+        const quotedMatches = message.match(/["'](.*?)["']/g);
+        if (quotedMatches) {
+            entities.push(...quotedMatches.map((m) => m.slice(1, -1)));
+        }
+        // Extract potential identifiers (CamelCase or snake_case)
+        const identifierMatches = message.match(/\b[A-Z][a-zA-Z0-9]*(?:_[a-zA-Z0-9]+)*\b/g);
+        if (identifierMatches) {
+            entities.push(...identifierMatches);
+        }
+        return [...new Set(entities)]; // Remove duplicates
+    }
+    /**
+     * Update the system prompt
+     */
+    setSystemPrompt(prompt) {
+        this.config.systemPrompt = prompt;
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=intent-parser.js.map

package/dist/core/intent-parser.js.map

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

package/dist/core/plan-generator.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Plan Generator
+ *
+ * Generates execution plans based on parsed intent and retrieved knowledge.
+ * Determines which tools to call and in what order.
+ *
+ * _Requirements: 1.3_
+ */
+import type { LLMManager } from '../llm/manager.js';
+import type { ChatMessage } from '../llm/adapter.js';
+import type { SearchResult } from '../types/knowledge.js';
+import type { DetailedIntent } from './intent-parser.js';
+import type { ToolRegistry } from './tool-registry.js';
+/**
+ * A single step in an execution plan
+ */
+export interface PlanStep {
+    /** Step number (1-based) */
+    stepNumber: number;
+    /** Tool to call */
+    toolName: string;
+    /** Arguments to pass to the tool */
+    arguments: Record<string, unknown>;
+    /** Description of what this step does */
+    description: string;
+    /** Whether this step depends on previous step results */
+    dependsOnPrevious: boolean;
+    /** Condition for executing this step (optional) */
+    condition?: string;
+}
+/**
+ * Complete execution plan
+ */
+export interface ExecutionPlan {
+    /** Unique plan ID */
+    id: string;
+    /** Steps to execute */
+    steps: PlanStep[];
+    /** Overall plan description */
+    description: string;
+    /** Estimated risk level */
+    riskLevel: 'low' | 'medium' | 'high';
+    /** Whether the plan requires user confirmation */
+    requiresConfirmation: boolean;
+    /** Confidence in the plan */
+    confidence: number;
+    /** Original intent that generated this plan */
+    intent: DetailedIntent;
+}
+/**
+ * Plan generation result
+ */
+export interface PlanGenerationResult {
+    /** Whether plan generation was successful */
+    success: boolean;
+    /** Generated plan (if successful) */
+    plan?: ExecutionPlan;
+    /** Reason for failure (if unsuccessful) */
+    failureReason?: string;
+    /** Missing information needed to generate plan */
+    missingInfo?: string[];
+    /** Alternative suggestions */
+    suggestions?: string[];
+}
+/**
+ * Plan generator configuration
+ */
+export interface PlanGeneratorConfig {
+    /** System prompt for plan generation */
+    systemPrompt?: string;
+    /** Maximum steps allowed in a plan */
+    maxSteps?: number;
+    /** Whether to require confirmation for high-risk operations */
+    requireConfirmationForHighRisk?: boolean;
+}
+/**
+ * Plan Generator
+ *
+ * Uses LLM to generate execution plans based on intent and available tools.
+ */
+export declare class PlanGenerator {
+    private llmManager;
+    private toolRegistry;
+    private config;
+    private planCounter;
+    constructor(llmManager: LLMManager, toolRegistry: ToolRegistry, config?: PlanGeneratorConfig);
+    /**
+     * Generate an execution plan based on intent and knowledge
+     *
+     * @param intent - Parsed user intent
+     * @param knowledge - Retrieved knowledge results
+     * @param history - Optional conversation history
+     * @returns Plan generation result
+     */
+    generate(intent: DetailedIntent, knowledge: SearchResult[], history?: ChatMessage[]): Promise<PlanGenerationResult>;
+    /**
+     * Build messages for LLM call
+     */
+    private buildMessages;
+    /**
+     * Build the user message with all context
+     */
+    private buildUserMessage;
+    /**
+     * Parse LLM response into PlanGenerationResult
+     */
+    private parseResponse;
+    /**
+     * Validate and build execution plan from parsed response
+     */
+    private validateAndBuildPlan;
+    /**
+     * Validate risk level
+     */
+    private validateRiskLevel;
+    /**
+     * Generate unique plan ID
+     */
+    private generatePlanId;
+    /**
+     * Create a simple single-step plan for direct tool calls
+     */
+    createDirectPlan(toolName: string, args: Record<string, unknown>, intent: DetailedIntent): ExecutionPlan;
+    /**
+     * Estimate risk level based on operation type and tools
+     */
+    estimateRiskLevel(intent: DetailedIntent, toolNames: string[]): 'low' | 'medium' | 'high';
+    /**
+     * Get current configuration
+     */
+    getConfig(): Required<PlanGeneratorConfig>;
+}
+//# sourceMappingURL=plan-generator.d.ts.map

package/dist/core/plan-generator.d.ts.map

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