@agenticc/core 1.0.0

package/dist/core/plan-generator.js

@@ -0,0 +1,294 @@
+/**
+ * Plan Generator
+ *
+ * Generates execution plans based on parsed intent and retrieved knowledge.
+ * Determines which tools to call and in what order.
+ *
+ * _Requirements: 1.3_
+ */
+const DEFAULT_SYSTEM_PROMPT = `You are a plan generator for a game server management system.
+Given a user intent and available tools, generate an execution plan.
+
+Your task:
+1. Analyze the intent and determine which tools are needed
+2. Order the tool calls appropriately (dependencies first)
+3. Provide arguments for each tool call
+4. Assess the risk level of the overall plan
+
+Respond in JSON format:
+{
+  "success": true/false,
+  "plan": {
+    "description": "Overall plan description",
+    "riskLevel": "low|medium|high",
+    "requiresConfirmation": true/false,
+    "confidence": 0.0-1.0,
+    "steps": [
+      {
+        "stepNumber": 1,
+        "toolName": "tool_name",
+        "arguments": { "arg1": "value1" },
+        "description": "What this step does",
+        "dependsOnPrevious": false,
+        "condition": "optional condition"
+      }
+    ]
+  },
+  "failureReason": "reason if success is false",
+  "missingInfo": ["list of missing information"],
+  "suggestions": ["alternative suggestions"]
+}`;
+/**
+ * Plan Generator
+ *
+ * Uses LLM to generate execution plans based on intent and available tools.
+ */
+export class PlanGenerator {
+    llmManager;
+    toolRegistry;
+    config;
+    planCounter = 0;
+    constructor(llmManager, toolRegistry, config) {
+        this.llmManager = llmManager;
+        this.toolRegistry = toolRegistry;
+        this.config = {
+            systemPrompt: config?.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+            maxSteps: config?.maxSteps ?? 10,
+            requireConfirmationForHighRisk: config?.requireConfirmationForHighRisk ?? true,
+        };
+    }
+    /**
+     * 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
+     */
+    async generate(intent, knowledge, history) {
+        const tools = this.toolRegistry.getDefinitions();
+        // If no tools available, return failure
+        if (tools.length === 0) {
+            return {
+                success: false,
+                failureReason: 'No tools available to execute the request',
+                suggestions: ['Register tools before generating plans'],
+            };
+        }
+        const messages = this.buildMessages(intent, knowledge, tools, history);
+        try {
+            const response = await this.llmManager.generate('tool_calling', messages, {
+                temperature: 0.2,
+            });
+            return this.parseResponse(response, intent);
+        }
+        catch (error) {
+            console.warn('Plan generation failed:', error);
+            return {
+                success: false,
+                failureReason: `Plan generation failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            };
+        }
+    }
+    /**
+     * Build messages for LLM call
+     */
+    buildMessages(intent, knowledge, tools, history) {
+        const messages = [{ role: 'system', content: this.config.systemPrompt }];
+        // Add conversation history
+        if (history && history.length > 0) {
+            messages.push(...history.slice(-3)); // Last 3 messages for context
+        }
+        // Build user message with context
+        const userMessage = this.buildUserMessage(intent, knowledge, tools);
+        messages.push({ role: 'user', content: userMessage });
+        return messages;
+    }
+    /**
+     * Build the user message with all context
+     */
+    buildUserMessage(intent, knowledge, tools) {
+        const parts = [];
+        // Intent information
+        parts.push('## User Intent');
+        parts.push(`Action: ${intent.action}`);
+        parts.push(`Operation Type: ${intent.operationType}`);
+        if (intent.target) {
+            parts.push(`Target: ${intent.target}`);
+        }
+        if (intent.entities.length > 0) {
+            parts.push(`Entities: ${intent.entities.join(', ')}`);
+        }
+        if (intent.parameters) {
+            parts.push(`Parameters: ${JSON.stringify(intent.parameters)}`);
+        }
+        parts.push(`Original Message: ${intent.originalMessage}`);
+        parts.push('');
+        // Available tools
+        parts.push('## Available Tools');
+        for (const tool of tools) {
+            parts.push(`- ${tool.function.name}: ${tool.function.description}`);
+            const params = tool.function.parameters;
+            if (params.required.length > 0) {
+                parts.push(`  Required params: ${params.required.join(', ')}`);
+            }
+        }
+        parts.push('');
+        // Retrieved knowledge
+        if (knowledge.length > 0) {
+            parts.push('## Relevant Knowledge');
+            for (const result of knowledge.slice(0, 5)) {
+                parts.push(`- [${result.document.category}] ${result.document.title || 'Untitled'}`);
+                parts.push(`  ${result.document.content.slice(0, 200)}...`);
+            }
+            parts.push('');
+        }
+        parts.push('Generate an execution plan based on the above information.');
+        return parts.join('\n');
+    }
+    /**
+     * Parse LLM response into PlanGenerationResult
+     */
+    parseResponse(response, intent) {
+        try {
+            // Extract JSON from response
+            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);
+            if (!parsed.success) {
+                return {
+                    success: false,
+                    failureReason: parsed.failureReason || 'Plan generation failed',
+                    missingInfo: parsed.missingInfo,
+                    suggestions: parsed.suggestions,
+                };
+            }
+            const plan = this.validateAndBuildPlan(parsed.plan, intent);
+            return {
+                success: true,
+                plan,
+            };
+        }
+        catch (error) {
+            console.warn('Failed to parse plan response:', error);
+            return {
+                success: false,
+                failureReason: 'Failed to parse plan generation response',
+            };
+        }
+    }
+    /**
+     * Validate and build execution plan from parsed response
+     */
+    validateAndBuildPlan(rawPlan, intent) {
+        const steps = [];
+        const rawSteps = Array.isArray(rawPlan.steps) ? rawPlan.steps : [];
+        for (let i = 0; i < Math.min(rawSteps.length, this.config.maxSteps); i++) {
+            const rawStep = rawSteps[i];
+            // Validate tool exists
+            const toolName = String(rawStep.toolName || '');
+            if (!this.toolRegistry.has(toolName)) {
+                console.warn(`Unknown tool in plan: ${toolName}`);
+                continue;
+            }
+            steps.push({
+                stepNumber: i + 1,
+                toolName,
+                arguments: typeof rawStep.arguments === 'object' && rawStep.arguments !== null
+                    ? rawStep.arguments
+                    : {},
+                description: String(rawStep.description || `Execute ${toolName}`),
+                dependsOnPrevious: Boolean(rawStep.dependsOnPrevious),
+                condition: rawStep.condition ? String(rawStep.condition) : undefined,
+            });
+        }
+        const riskLevel = this.validateRiskLevel(rawPlan.riskLevel);
+        const requiresConfirmation = this.config.requireConfirmationForHighRisk &&
+            (riskLevel === 'high' || Boolean(rawPlan.requiresConfirmation));
+        return {
+            id: this.generatePlanId(),
+            steps,
+            description: String(rawPlan.description || 'Execution plan'),
+            riskLevel,
+            requiresConfirmation,
+            confidence: typeof rawPlan.confidence === 'number' ? Math.max(0, Math.min(1, rawPlan.confidence)) : 0.5,
+            intent,
+        };
+    }
+    /**
+     * Validate risk level
+     */
+    validateRiskLevel(level) {
+        if (level === 'low' || level === 'medium' || level === 'high') {
+            return level;
+        }
+        return 'medium';
+    }
+    /**
+     * Generate unique plan ID
+     */
+    generatePlanId() {
+        this.planCounter++;
+        return `plan_${Date.now()}_${this.planCounter}`;
+    }
+    /**
+     * Create a simple single-step plan for direct tool calls
+     */
+    createDirectPlan(toolName, args, intent) {
+        const tool = this.toolRegistry.get(toolName);
+        const riskLevel = tool?.riskLevel ?? 'low';
+        return {
+            id: this.generatePlanId(),
+            steps: [
+                {
+                    stepNumber: 1,
+                    toolName,
+                    arguments: args,
+                    description: `Execute ${toolName}`,
+                    dependsOnPrevious: false,
+                },
+            ],
+            description: `Direct execution of ${toolName}`,
+            riskLevel,
+            requiresConfirmation: tool?.requiresConfirmation ??
+                (this.config.requireConfirmationForHighRisk && riskLevel === 'high'),
+            confidence: 1.0,
+            intent,
+        };
+    }
+    /**
+     * Estimate risk level based on operation type and tools
+     */
+    estimateRiskLevel(intent, toolNames) {
+        // High risk operations
+        if (intent.operationType === 'delete') {
+            return 'high';
+        }
+        // Check tool risk levels
+        for (const name of toolNames) {
+            const tool = this.toolRegistry.get(name);
+            if (tool?.riskLevel === 'high') {
+                return 'high';
+            }
+        }
+        // Medium risk operations
+        if (intent.operationType === 'update' || intent.operationType === 'configure') {
+            return 'medium';
+        }
+        // Check for medium risk tools
+        for (const name of toolNames) {
+            const tool = this.toolRegistry.get(name);
+            if (tool?.riskLevel === 'medium') {
+                return 'medium';
+            }
+        }
+        return 'low';
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=plan-generator.js.map

package/dist/core/plan-generator.js.map

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

package/dist/core/plugin-manager.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Plugin Manager
+ *
+ * Manages plugin lifecycle, tool registration, and namespace handling.
+ * Provides dependency injection for plugins through PluginContext.
+ *
+ * @module core/plugin-manager
+ */
+import type { AgentPlugin, PluginContext, PluginInfo, PluginManagerOptions } from '../types/plugin.js';
+import type { Tool, ToolDefinition } from '../types/tool.js';
+/**
+ * Error thrown when plugin operations fail
+ */
+export declare class PluginError extends Error {
+    readonly pluginName: string;
+    readonly reason: string;
+    constructor(message: string, pluginName: string, reason: string);
+}
+/**
+ * Plugin Manager
+ *
+ * Handles plugin loading, unloading, and tool management.
+ * Supports namespace-based tool isolation, dependency injection, and dependency resolution.
+ */
+export declare class PluginManager {
+    private plugins;
+    private allTools;
+    private options;
+    private context?;
+    private loadingPlugins;
+    constructor(options?: Partial<PluginManagerOptions>);
+    /**
+     * Set the plugin context for dependency injection
+     */
+    setContext(context: PluginContext): void;
+    /**
+     * Load a plugin
+     *
+     * @param plugin - The plugin to load
+     * @throws PluginError if loading fails
+     */
+    load(plugin: AgentPlugin): Promise<void>;
+    /**
+     * Load plugin dependencies
+     * @private
+     */
+    private loadDependencies;
+    /**
+     * Unload a plugin
+     *
+     * @param pluginName - Name of the plugin to unload
+     * @returns true if unloaded, false if not found
+     */
+    unload(pluginName: string): Promise<boolean>;
+    /**
+     * Get a plugin by name
+     */
+    getPlugin(name: string): AgentPlugin | undefined;
+    /**
+     * Check if a plugin is loaded
+     */
+    hasPlugin(name: string): boolean;
+    /**
+     * List all loaded plugins
+     */
+    listPlugins(): PluginInfo[];
+    /**
+     * Get a tool by name
+     */
+    getTool(name: string): Tool | undefined;
+    /**
+     * Check if a tool exists
+     */
+    hasTool(name: string): boolean;
+    /**
+     * List all tools
+     */
+    listTools(): Tool[];
+    /**
+     * List tool names
+     */
+    listToolNames(): string[];
+    /**
+     * Get tool definitions for LLM Function Calling
+     */
+    getToolDefinitions(): ToolDefinition[];
+    /**
+     * Get the number of loaded plugins
+     */
+    get pluginCount(): number;
+    /**
+     * Get the number of registered tools
+     */
+    get toolCount(): number;
+    /**
+     * Clear all plugins
+     */
+    clear(): Promise<void>;
+    /**
+     * Run health checks on all plugins
+     */
+    healthCheck(): Promise<Map<string, boolean>>;
+    /**
+     * Get namespaced tool name
+     */
+    private getNamespacedToolName;
+    /**
+     * Handle tool name conflict
+     */
+    private handleConflict;
+    /**
+     * Validate plugin definition
+     */
+    private validatePlugin;
+    /**
+     * Validate tool definition
+     */
+    private validateTool;
+}
+//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/core/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/core/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,oBAAoB,EAErB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAI7D;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAGlB,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,MAAM;gBAF9B,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;CAKjC;AAYD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,cAAc,CAA0B;gBAEpC,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAIvD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwF9C;;;OAGG;YACW,gBAAgB;IAyB9B;;;;;OAKG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BlD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAa3B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,SAAS,IAAI,IAAI,EAAE;IAInB;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,kBAAkB,IAAI,cAAc,EAAE;IAItC;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkBlD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6EtB;;OAEG;IACH,OAAO,CAAC,YAAY;CAqFrB"}