@agenticc/core 1.0.0

package/dist/core/response-handler.js

@@ -0,0 +1,384 @@
+/**
+ * Response Handler
+ *
+ * Generates appropriate responses based on execution results,
+ * knowledge assessment, and user interaction needs.
+ *
+ * _Requirements: 1.4, 5.1-5.5_
+ */
+const DEFAULT_SYSTEM_PROMPT = `You are a helpful assistant for a game server management system.
+Generate clear, concise responses based on the execution results provided.
+Use the user's language (Chinese or English) based on their input.
+Be specific about what was done and any relevant details.`;
+/**
+ * Response Handler
+ *
+ * Determines the appropriate response type and generates responses
+ * based on the current state of agent processing.
+ */
+export class ResponseHandler {
+    llmManager;
+    config;
+    constructor(llmManager, config) {
+        this.llmManager = llmManager;
+        this.config = {
+            systemPrompt: config?.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+            includeToolDetails: config?.includeToolDetails ?? true,
+            maxResponseLength: config?.maxResponseLength ?? 2000,
+        };
+    }
+    /**
+     * Generate an appropriate response based on context
+     */
+    async generateResponse(context) {
+        // If we have successful execution results, prioritize returning them
+        if (context.executionResults && context.executionResults.length > 0) {
+            const hasSuccess = context.executionResults.some((r) => r.success);
+            if (hasSuccess) {
+                return this.createExecuteResponse(context);
+            }
+        }
+        // Check if we need to request knowledge
+        if (this.shouldRequestKnowledge(context)) {
+            return this.createKnowledgeRequestResponse(context);
+        }
+        // Check if we need clarification
+        if (this.shouldRequestClarification(context)) {
+            return this.createClarifyResponse(context);
+        }
+        // Check if we need confirmation
+        if (this.shouldRequestConfirmation(context)) {
+            return this.createConfirmResponse(context);
+        }
+        // Check if we should present options
+        if (this.shouldPresentOptions(context)) {
+            return this.createOptionsResponse(context);
+        }
+        // Generate execute response
+        return this.createExecuteResponse(context);
+    }
+    /**
+     * Check if knowledge request is needed
+     */
+    shouldRequestKnowledge(context) {
+        const assessment = context.knowledgeAssessment;
+        return assessment?.status === 'insufficient' && context.intent.confidence > 0.5; // Only if we understand the intent
+    }
+    /**
+     * Check if clarification is needed
+     */
+    shouldRequestClarification(context) {
+        // Low confidence intent
+        if (context.intent.confidence < 0.4) {
+            return true;
+        }
+        // Ambiguous knowledge
+        if (context.knowledgeAssessment?.status === 'ambiguous') {
+            return true;
+        }
+        // Unknown operation type with no clear target
+        if (context.intent.operationType === 'unknown' && !context.intent.target) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Check if confirmation is needed
+     */
+    shouldRequestConfirmation(context) {
+        return context.plan?.requiresConfirmation === true;
+    }
+    /**
+     * Check if options should be presented
+     */
+    shouldPresentOptions(context) {
+        const assessment = context.knowledgeAssessment;
+        return (assessment?.status === 'ambiguous' &&
+            assessment.alternatives !== undefined &&
+            assessment.alternatives.length > 1);
+    }
+    /**
+     * Create a knowledge request response
+     */
+    createKnowledgeRequestResponse(context) {
+        const assessment = context.knowledgeAssessment;
+        const topic = assessment.missingTopic || context.intent.action;
+        const options = [
+            {
+                id: 'provide_text',
+                type: 'provide_text',
+                label: '提供文本信息',
+                description: '直接输入相关信息',
+            },
+            {
+                id: 'upload_file',
+                type: 'upload_file',
+                label: '上传文件',
+                description: '上传包含相关信息的文件',
+            },
+            {
+                id: 'skip',
+                type: 'skip',
+                label: '跳过',
+                description: '跳过此步骤，继续其他操作',
+            },
+            {
+                id: 'try_anyway',
+                type: 'try_anyway',
+                label: '尝试继续',
+                description: '使用现有知识尝试执行',
+            },
+        ];
+        return {
+            type: 'knowledge_request',
+            message: `我需要更多关于 "${topic}" 的信息来完成您的请求。`,
+            missing: {
+                topic,
+                description: `缺少关于 ${topic} 的详细信息，无法准确执行操作。`,
+            },
+            options,
+        };
+    }
+    /**
+     * Create a clarify response
+     */
+    async createClarifyResponse(context) {
+        const questions = await this.generateClarifyingQuestions(context);
+        return {
+            type: 'clarify',
+            message: '我需要一些额外信息来更好地理解您的请求。',
+            questions,
+        };
+    }
+    /**
+     * Generate clarifying questions using LLM
+     */
+    async generateClarifyingQuestions(context) {
+        try {
+            const prompt = `Based on this user message: "${context.userMessage}"
+      
+The intent was parsed as:
+- Action: ${context.intent.action}
+- Operation: ${context.intent.operationType}
+- Confidence: ${context.intent.confidence}
+
+Generate 2-3 clarifying questions to better understand what the user wants.
+Respond with a JSON array of questions in the user's language.`;
+            const response = await this.llmManager.generate('response_generation', [
+                { role: 'system', content: 'Generate clarifying questions. Respond with a JSON array.' },
+                { role: 'user', content: prompt },
+            ], { temperature: 0.3 });
+            const match = response.match(/\[[\s\S]*\]/);
+            if (match) {
+                const questions = JSON.parse(match[0]);
+                if (Array.isArray(questions)) {
+                    return questions.map((q) => String(q)).slice(0, 3);
+                }
+            }
+        }
+        catch (error) {
+            console.warn('Failed to generate clarifying questions:', error);
+        }
+        // Fallback questions
+        return ['您能更详细地描述您想要做什么吗？', '您要操作的具体对象是什么？'];
+    }
+    /**
+     * Create a confirm response
+     */
+    createConfirmResponse(context) {
+        const plan = context.plan;
+        const firstStep = plan.steps[0];
+        // Generate preview of changes
+        const preview = this.generatePlanPreview(plan);
+        return {
+            type: 'confirm',
+            message: `即将执行以下操作，请确认：`,
+            action: {
+                type: context.intent.operationType,
+                target: context.intent.target || firstStep?.toolName || 'unknown',
+                params: firstStep?.arguments || {},
+            },
+            risk: plan.riskLevel,
+            preview,
+        };
+    }
+    /**
+     * Generate a preview of the execution plan
+     */
+    generatePlanPreview(plan) {
+        const lines = [];
+        lines.push(`计划: ${plan.description}`);
+        lines.push(`风险等级: ${plan.riskLevel}`);
+        lines.push('');
+        lines.push('执行步骤:');
+        for (const step of plan.steps) {
+            lines.push(`${step.stepNumber}. ${step.description}`);
+            if (Object.keys(step.arguments).length > 0) {
+                lines.push(`   参数: ${JSON.stringify(step.arguments)}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Create an options response
+     */
+    createOptionsResponse(context) {
+        const alternatives = context.knowledgeAssessment?.alternatives || [];
+        const options = alternatives.map((alt, index) => ({
+            id: `option_${index}`,
+            label: alt.interpretation,
+            description: `置信度: ${(alt.confidence * 100).toFixed(0)}%`,
+            metadata: { confidence: alt.confidence },
+        }));
+        return {
+            type: 'options',
+            message: '发现多个可能的选项，请选择您想要的：',
+            options,
+        };
+    }
+    /**
+     * Create an execute response
+     */
+    async createExecuteResponse(context) {
+        const results = context.executionResults || [];
+        const toolCalls = this.buildToolCallRecords(results);
+        // Generate response message using LLM
+        const message = await this.generateExecuteMessage(context, results);
+        // Collect data from successful executions
+        const data = this.collectExecutionData(results);
+        return {
+            type: 'execute',
+            message,
+            data: Object.keys(data).length > 0 ? data : undefined,
+            toolCalls: this.config.includeToolDetails ? toolCalls : undefined,
+        };
+    }
+    /**
+     * Build tool call records from execution results
+     */
+    buildToolCallRecords(results) {
+        return results.map((result) => ({
+            toolName: result.toolName,
+            arguments: result.arguments,
+            result: {
+                success: result.success,
+                content: result.result.content,
+                data: result.result.data,
+            },
+        }));
+    }
+    /**
+     * Generate execute response message using LLM
+     */
+    async generateExecuteMessage(context, results) {
+        // If no results, generate a simple response
+        if (results.length === 0) {
+            return this.generateNoActionMessage(context);
+        }
+        try {
+            const prompt = this.buildExecuteMessagePrompt(context, results);
+            const response = await this.llmManager.generate('response_generation', [
+                { role: 'system', content: this.config.systemPrompt },
+                { role: 'user', content: prompt },
+            ], { temperature: 0.5 });
+            // Truncate if too long
+            if (response.length > this.config.maxResponseLength) {
+                return response.slice(0, this.config.maxResponseLength) + '...';
+            }
+            return response;
+        }
+        catch (error) {
+            console.warn('Failed to generate execute message:', error);
+            return this.generateFallbackMessage(results);
+        }
+    }
+    /**
+     * Build prompt for execute message generation
+     */
+    buildExecuteMessagePrompt(context, results) {
+        const parts = [];
+        parts.push(`User request: ${context.userMessage}`);
+        parts.push('');
+        parts.push('Execution results:');
+        for (const result of results) {
+            parts.push(`- Tool: ${result.toolName}`);
+            parts.push(`  Success: ${result.success}`);
+            parts.push(`  Result: ${result.result.content}`);
+            if (result.result.data) {
+                parts.push(`  Data: ${JSON.stringify(result.result.data).slice(0, 200)}`);
+            }
+        }
+        parts.push('');
+        parts.push('Generate a helpful response summarizing what was done.');
+        parts.push('Use the same language as the user (Chinese or English).');
+        return parts.join('\n');
+    }
+    /**
+     * Generate message when no action was taken
+     */
+    generateNoActionMessage(context) {
+        if (context.searchResults && context.searchResults.length > 0) {
+            return '根据您的请求，我找到了以下相关信息。';
+        }
+        return '我理解了您的请求，但目前没有需要执行的操作。';
+    }
+    /**
+     * Generate fallback message when LLM fails
+     */
+    generateFallbackMessage(results) {
+        const successful = results.filter((r) => r.success);
+        const failed = results.filter((r) => !r.success);
+        const parts = [];
+        if (successful.length > 0) {
+            parts.push(`成功执行了 ${successful.length} 个操作。`);
+        }
+        if (failed.length > 0) {
+            parts.push(`${failed.length} 个操作失败。`);
+            for (const f of failed) {
+                parts.push(`- ${f.toolName}: ${f.result.content}`);
+            }
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Collect data from execution results
+     */
+    collectExecutionData(results) {
+        const data = {};
+        for (const result of results) {
+            if (result.success && result.result.data !== undefined) {
+                data[result.toolName] = result.result.data;
+            }
+        }
+        return data;
+    }
+    /**
+     * Create a simple execute response without LLM
+     */
+    createSimpleExecuteResponse(message, data, toolCalls) {
+        return {
+            type: 'execute',
+            message,
+            data,
+            toolCalls,
+        };
+    }
+    /**
+     * Create an error response
+     */
+    createErrorResponse(error) {
+        const message = error instanceof Error ? error.message : error;
+        return {
+            type: 'execute',
+            message: `操作失败: ${message}`,
+            data: { error: true },
+        };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=response-handler.js.map

package/dist/core/response-handler.js.map

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

package/dist/core/tool-executor.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Tool Executor
+ *
+ * Handles the execution of tools with parameter validation,
+ * context injection, and error handling.
+ *
+ * @module core/tool-executor
+ */
+import type { ToolResult, ToolLogger } from '../types/tool.js';
+import type { KnowledgeBase } from '../types/knowledge.js';
+import { ToolRegistry } from './tool-registry.js';
+/**
+ * Error thrown when tool parameter validation fails
+ */
+export declare class ToolValidationError extends Error {
+    readonly toolName: string;
+    readonly parameterName: string;
+    readonly reason: string;
+    constructor(message: string, toolName: string, parameterName: string, reason: string);
+}
+/**
+ * Error thrown when tool execution fails
+ */
+export declare class ToolExecutionError extends Error {
+    readonly toolName: string;
+    readonly cause?: Error;
+    constructor(message: string, toolName: string, cause?: Error);
+}
+/**
+ * Error thrown when tool execution times out
+ */
+export declare class ToolTimeoutError extends Error {
+    readonly toolName: string;
+    readonly timeoutMs: number;
+    constructor(toolName: string, timeoutMs: number);
+}
+/**
+ * Options for tool execution
+ */
+export interface ToolExecutorOptions {
+    /** Default timeout for tool execution in milliseconds (default: 30000) */
+    defaultTimeout?: number;
+    /** Whether to validate parameters strictly (default: true) */
+    strictValidation?: boolean;
+}
+/**
+ * Context provider for tool execution
+ */
+export interface ToolContextProvider {
+    /** Get the knowledge base instance */
+    getKnowledgeBase(): KnowledgeBase;
+    /** Get the current session ID */
+    getSessionId(): string;
+    /** Get the logger instance */
+    getLogger(): ToolLogger;
+}
+/**
+ * Result of a tool execution including metadata
+ */
+export interface ToolExecutionResult {
+    /** The tool result */
+    result: ToolResult;
+    /** Tool name that was executed */
+    toolName: string;
+    /** Arguments passed to the tool */
+    arguments: Record<string, unknown>;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Whether the execution was successful */
+    success: boolean;
+    /** Error if execution failed */
+    error?: Error;
+}
+/**
+ * Tool Executor
+ *
+ * Executes tools with parameter validation, context injection,
+ * timeout handling, and error management.
+ */
+export declare class ToolExecutor {
+    private registry;
+    private options;
+    private contextProvider?;
+    constructor(registry: ToolRegistry, options?: ToolExecutorOptions);
+    /**
+     * Set the context provider for tool execution
+     */
+    setContextProvider(provider: ToolContextProvider): void;
+    /**
+     * Create a tool context from the provider or defaults
+     */
+    private createContext;
+    /**
+     * Execute a tool by name with the given arguments
+     *
+     * @param toolName - Name of the tool to execute
+     * @param args - Arguments to pass to the tool
+     * @param options - Execution options
+     * @returns The execution result
+     */
+    execute(toolName: string, args: Record<string, unknown>, options?: {
+        sessionId?: string;
+        timeout?: number;
+    }): Promise<ToolExecutionResult>;
+    /**
+     * Execute multiple tools in sequence
+     *
+     * @param calls - Array of tool calls to execute
+     * @param options - Execution options
+     * @returns Array of execution results
+     */
+    executeSequence(calls: Array<{
+        toolName: string;
+        args: Record<string, unknown>;
+    }>, options?: {
+        sessionId?: string;
+        timeout?: number;
+        stopOnError?: boolean;
+    }): Promise<ToolExecutionResult[]>;
+    /**
+     * Execute multiple tools in parallel
+     *
+     * @param calls - Array of tool calls to execute
+     * @param options - Execution options
+     * @returns Array of execution results
+     */
+    executeParallel(calls: Array<{
+        toolName: string;
+        args: Record<string, unknown>;
+    }>, options?: {
+        sessionId?: string;
+        timeout?: number;
+    }): Promise<ToolExecutionResult[]>;
+    /**
+     * Check if a tool requires confirmation before execution
+     */
+    requiresConfirmation(toolName: string): boolean;
+    /**
+     * Get the risk level of a tool
+     */
+    getRiskLevel(toolName: string): 'low' | 'medium' | 'high' | undefined;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/core/tool-executor.d.ts.map

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