@operor/core 0.1.0

package/src/KeywordIntentClassifier.ts

@@ -0,0 +1,74 @@
+import type { Intent, IntentClassifier, AgentConfig, ConversationMessage } from './types.js';
+
+/**
+ * Default keyword-based intent classifier.
+ * Uses simple keyword matching to classify user messages.
+ */
+export class KeywordIntentClassifier implements IntentClassifier {
+  async classify(
+    message: string,
+    agents: AgentConfig[],
+    history?: ConversationMessage[]
+  ): Promise<Intent> {
+    const lowerText = message.toLowerCase();
+
+    // Try to match against agent triggers
+    for (const agent of agents) {
+      if (!agent.triggers) continue;
+
+      for (const trigger of agent.triggers) {
+        if (lowerText.includes(trigger.toLowerCase())) {
+          return {
+            intent: trigger,
+            confidence: 0.9,
+            entities: {},
+          };
+        }
+      }
+    }
+
+    // Fallback keyword matching
+    if (
+      lowerText.includes('order') ||
+      lowerText.includes('tracking') ||
+      lowerText.includes('where is') ||
+      lowerText.includes('delivery')
+    ) {
+      return {
+        intent: 'order_tracking',
+        confidence: 0.95,
+        entities: {},
+      };
+    }
+
+    if (
+      lowerText.includes('product') ||
+      lowerText.includes('buy') ||
+      lowerText.includes('price')
+    ) {
+      return {
+        intent: 'product_inquiry',
+        confidence: 0.9,
+        entities: {},
+      };
+    }
+
+    if (
+      lowerText.includes('help') ||
+      lowerText.includes('support') ||
+      lowerText.includes('problem')
+    ) {
+      return {
+        intent: 'support',
+        confidence: 0.85,
+        entities: {},
+      };
+    }
+
+    return {
+      intent: 'general',
+      confidence: 0.5,
+      entities: {},
+    };
+  }
+}

package/src/LLMIntentClassifier.ts

@@ -0,0 +1,68 @@
+import type { Intent, IntentClassifier, AgentConfig, ConversationMessage } from './types.js';
+
+/**
+ * LLM-based intent classifier.
+ * Uses an LLM to classify user messages based on agent configurations.
+ * Requires an LLM provider (AIProvider from @operor/llm).
+ */
+export class LLMIntentClassifier implements IntentClassifier {
+  constructor(private llm: any) {}
+
+  async classify(
+    message: string,
+    agents: AgentConfig[],
+    history?: ConversationMessage[]
+  ): Promise<Intent> {
+    const agentDescriptions = agents
+      .map(
+        (a) =>
+          `- ${a.name}: triggers=[${a.triggers?.join(', ')}], purpose="${a.purpose || 'N/A'}"`
+      )
+      .join('\n');
+
+    const systemPrompt = `You are an intent classifier for a customer service system. Classify the user message into one of these agent categories:
+
+${agentDescriptions}
+
+Respond with JSON only (no markdown, no code blocks):
+{
+  "intent": "trigger_name",
+  "confidence": 0.0-1.0,
+  "entities": {}
+}
+
+Choose the most appropriate trigger from the list above. If none match well, use "general".`;
+
+    try {
+      const response = await this.llm.complete(
+        [
+          { role: 'system', content: systemPrompt },
+          { role: 'user', content: message },
+        ],
+        { maxTokens: 150, temperature: 0 }
+      );
+
+      // Parse JSON response
+      const text = response.text.trim();
+      const jsonMatch = text.match(/\{[\s\S]*\}/);
+      if (!jsonMatch) {
+        throw new Error('No JSON found in LLM response');
+      }
+
+      const parsed = JSON.parse(jsonMatch[0]);
+      return {
+        intent: parsed.intent || 'general',
+        confidence: parsed.confidence || 0.5,
+        entities: parsed.entities || {},
+      };
+    } catch (error) {
+      console.error('LLM intent classification failed:', error);
+      // Fallback to general intent
+      return {
+        intent: 'general',
+        confidence: 0.3,
+        entities: {},
+      };
+    }
+  }
+}