chat-flow-ardymalihi 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 [Your Organization]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,266 @@
+# Chat-Flow
+
+A production-ready conversation orchestration library with intent detection and workflow integration.
+
+[![npm version](https://img.shields.io/npm/v/@your-org/chat-flow.svg)](https://www.npmjs.com/package/@your-org/chat-flow)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 🎯 **Intent Detection** - AI-powered intent classification with confidence scoring
+- 💬 **Session Management** - Persistent conversation sessions with Redis or in-memory storage
+- 🔄 **Workflow Integration** - Seamless integration with workflow engines (Zapier, N8N, etc.)
+- 🤖 **LLM Adapters** - Support for multiple LLM providers (Gemini, OpenAI, etc.)
+- 🏗️ **Clean Architecture** - Ports & Adapters pattern for maximum flexibility
+- 📊 **Type-Safe** - Full TypeScript support with comprehensive type definitions
+- ✅ **Well-Tested** - Comprehensive test coverage
+- 🔧 **Configurable** - Flexible configuration system
+
+## Installation
+
+```bash
+npm install @your-org/chat-flow
+```
+
+## Quick Start
+
+```typescript
+import {
+    Orchestrator,
+    GeminiLLMAdapter,
+    RedisRepository,
+    IntentService,
+    IntentRepository,
+    IntentMatcher,
+    MockWorkflowAdapter
+} from '@your-org/chat-flow';
+
+// Initialize adapters
+const llm = new GeminiLLMAdapter(process.env.GOOGLE_AI_API_KEY!);
+const repository = new RedisRepository('redis://localhost:6379');
+const intentRepo = new IntentRepository(repository);
+const intentMatcher = new IntentMatcher(llm);
+const intentService = new IntentService(intentRepo, intentMatcher);
+const workflow = new MockWorkflowAdapter();
+
+// Create orchestrator with custom config
+const orchestrator = new Orchestrator(
+    repository,
+    llm,
+    intentService,
+    workflow,
+    {
+        intent: {
+            confidenceThreshold: 0.7,
+            maxIntents: 5,
+            cacheTTL: 300
+        }
+    }
+);
+
+// Create a session
+const session = await orchestrator.createSession(
+    'session-123',
+    'TEXT',
+    'You are a helpful travel assistant'
+);
+
+// Handle user messages
+const { messages, metadata } = await orchestrator.handleMessage(
+    session.sessionId,
+    'I want to book a flight to Paris'
+);
+
+console.log('Assistant:', messages[0].content);
+console.log('Intent detected:', metadata.intent);
+console.log('Confidence:', metadata.confidence);
+```
+
+## Core Concepts
+
+### Session Management
+
+Sessions maintain conversation state and history:
+
+```typescript
+const session = await orchestrator.createSession(
+    'unique-session-id',
+    'TEXT', // or 'VOICE'
+    'Your agent prompt here'
+);
+```
+
+### Intent Detection
+
+Automatically detect user intents with confidence scoring:
+
+```typescript
+// Define intents
+const intents = [
+    {
+        name: 'BOOK_FLIGHT',
+        description: 'User wants to book a flight',
+        required_fields: [
+            { name: 'destination', type: 'string' },
+            { name: 'date', type: 'string' }
+        ]
+    }
+];
+
+await intentRepo.upsertIntents(intents);
+```
+
+### Workflow Integration
+
+Execute workflows when intents are detected:
+
+```typescript
+class CustomWorkflowAdapter implements IWorkflowAdapter {
+    async executeWorkflow(workflowId: string, context: any): Promise<WorkflowResult> {
+        // Your workflow execution logic
+        return {
+            success: true,
+            data: { /* workflow results */ }
+        };
+    }
+}
+```
+
+## Configuration
+
+Customize behavior with configuration options:
+
+```typescript
+const config = {
+    session: {
+        ttl: 3600,              // Session TTL in seconds
+        maxHistoryLength: 100   // Max messages to keep
+    },
+    intent: {
+        confidenceThreshold: 0.6,  // Minimum confidence (0-1)
+        maxIntents: 5,             // Max intents to return
+        cacheTTL: 300              // Cache TTL in seconds
+    },
+    llm: {
+        model: 'gemini-2.0-flash-lite',
+        temperature: 0.7,
+        maxTokens: 1000,
+        timeout: 30000
+    },
+    workflow: {
+        timeout: 60000,
+        retries: 3,
+        retryDelay: 1000
+    },
+    logging: {
+        enabled: true,
+        level: 'info',
+        timestamps: true
+    }
+};
+
+const orchestrator = new Orchestrator(repo, llm, intent, workflow, config);
+```
+
+## Error Handling
+
+Chat-Flow provides typed errors for better error handling:
+
+```typescript
+import {
+    SessionNotFoundError,
+    IntentDetectionError,
+    WorkflowExecutionError,
+    LLMError
+} from '@your-org/chat-flow';
+
+try {
+    await orchestrator.handleMessage(sessionId, message);
+} catch (error) {
+    if (error instanceof SessionNotFoundError) {
+        console.error('Session not found:', error.details.sessionId);
+    } else if (error instanceof IntentDetectionError) {
+        console.error('Intent detection failed:', error.message);
+    }
+}
+```
+
+## Architecture
+
+Chat-Flow follows Clean Architecture principles:
+
+```
+┌─────────────────────────────────────────┐
+│         Application Layer               │
+│  (Orchestrator, ConversationSession)    │
+└─────────────────────────────────────────┘
+                  ↓
+┌─────────────────────────────────────────┐
+│           Ports (Interfaces)            │
+│  (IRepository, ILLMAdapter, etc.)       │
+└─────────────────────────────────────────┘
+                  ↓
+┌─────────────────────────────────────────┐
+│        Adapters (Implementations)       │
+│  (RedisRepository, GeminiLLMAdapter)    │
+└─────────────────────────────────────────┘
+```
+
+## Testing
+
+```bash
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run linter
+npm run lint
+
+# Format code
+npm run format
+
+# Run demo
+npm run demo
+```
+
+## Examples
+
+See the `/examples` directory for more usage examples:
+
+- Basic chat implementation
+- Custom intent detection
+- Workflow integration
+- Custom adapters
+
+## API Documentation
+
+For detailed API documentation, see [API.md](./docs/API.md).
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
+
+## License
+
+MIT © [Your Organization]
+
+## Support
+
+- 📧 Email: support@your-org.com
+- 💬 Discord: [Join our community](https://discord.gg/your-server)
+- 🐛 Issues: [GitHub Issues](https://github.com/your-org/chat-flow/issues)

package/dist/adapters/db/InMemorySessionRepository.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemorySessionRepository = void 0;
+class InMemorySessionRepository {
+    constructor() {
+        this.sessions = new Map();
+    }
+    async save(session) {
+        this.sessions.set(session.sessionId, session);
+    }
+    async findById(sessionId) {
+        return this.sessions.get(sessionId) || null;
+    }
+}
+exports.InMemorySessionRepository = InMemorySessionRepository;

package/dist/adapters/db/RedisSessionRepository.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisSessionRepository = void 0;
+const ioredis_1 = __importDefault(require("ioredis"));
+const ConversationSession_1 = require("../../domain/conversation/ConversationSession");
+class RedisSessionRepository {
+    constructor(connectionString = 'redis://localhost:6379') {
+        this.TTL_SECONDS = 3600; // 1 Hour Expiry
+        this.client = new ioredis_1.default(connectionString);
+        this.client.on('error', (err) => {
+            console.error('[Redis Error]', err);
+        });
+    }
+    async save(session) {
+        const key = `session:${session.sessionId}`;
+        const data = JSON.stringify(session.toSnapshot());
+        await this.client.set(key, data, 'EX', this.TTL_SECONDS);
+    }
+    async findById(sessionId) {
+        const key = `session:${sessionId}`;
+        const data = await this.client.get(key);
+        if (!data)
+            return null;
+        try {
+            const parsed = JSON.parse(data);
+            return ConversationSession_1.ConversationSession.reconstitute(parsed);
+        }
+        catch (err) {
+            console.error(`Failed to reconstitute session ${sessionId}`, err);
+            return null;
+        }
+    }
+    // Helper to close connection
+    async disconnect() {
+        await this.client.quit();
+    }
+}
+exports.RedisSessionRepository = RedisSessionRepository;

package/dist/adapters/intent/IntentMatcher.d.ts

@@ -0,0 +1,25 @@
+import { ILLMAdapter, Intent, MatchedIntent, Message } from '../../interfaces';
+/**
+ * Intent matcher that uses LLM to match user context against known intents
+ */
+export declare class IntentMatcher {
+    private llm;
+    constructor(llm: ILLMAdapter);
+    /**
+     * Match user context against a list of intents
+     * @param context User context (string or object)
+     * @param intents Available intents to match against
+     * @param confidenceThreshold Minimum confidence threshold (0-100)
+     * @returns Array of matched intents above threshold
+     */
+    matchIntents(context: string | object, intents: Intent[], confidenceThreshold?: number): Promise<MatchedIntent[]>;
+    /**
+     * Detect intent from conversation history
+     * @param history Conversation history
+     * @param intents Available intents
+     * @param confidenceThreshold Minimum confidence threshold (0-100)
+     * @returns Best matched intent or null
+     */
+    detectFromHistory(history: Message[], intents: Intent[], confidenceThreshold?: number): Promise<MatchedIntent | null>;
+}
+//# sourceMappingURL=IntentMatcher.d.ts.map

package/dist/adapters/intent/IntentMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentMatcher.d.ts","sourceRoot":"","sources":["../../../src/adapters/intent/IntentMatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG/E;;GAEG;AACH,qBAAa,aAAa;IACV,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,WAAW;IAEpC;;;;;;OAMG;IACG,YAAY,CACd,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,GAAE,MAAW,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC;IA2D3B;;;;;;OAMG;IACG,iBAAiB,CACnB,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,GAAE,MAAW,GACjC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CASnC"}

package/dist/adapters/intent/IntentMatcher.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentMatcher = void 0;
+const errors_1 = require("../../core/errors");
+/**
+ * Intent matcher that uses LLM to match user context against known intents
+ */
+class IntentMatcher {
+    constructor(llm) {
+        this.llm = llm;
+    }
+    /**
+     * Match user context against a list of intents
+     * @param context User context (string or object)
+     * @param intents Available intents to match against
+     * @param confidenceThreshold Minimum confidence threshold (0-100)
+     * @returns Array of matched intents above threshold
+     */
+    async matchIntents(context, intents, confidenceThreshold = 70) {
+        if (intents.length === 0)
+            return [];
+        const contextStr = typeof context === "string" ? context : JSON.stringify(context);
+        const prompt = `
+You are a strict known intent classifier.
+Analyze the Context and determine if it strictly matches one of the provided Intents.
+
+CRITICAL RULES:
+1. Determine if the user's INTENTION matches one of the provided Intents.
+2. If the user is strictly greeting, asking about capabilities, or chatting off-topic, return an EMPTY array [].
+3. For a matched intent, extract EXPECTED values from the context.
+4. If a required field is missing, you MUST still return the intent if the user's goal is clearly to perform that action (e.g. "Book a flight" -> BOOK_FLIGHT, even if date is missing).
+5. Do NOT hallucinate values. If a value is not in the text, return null or omit it.
+
+Filter conditions:
+  - Confidence >= ${confidenceThreshold}
+
+Return JSON with the format:
+[
+  {
+    "intentName": string,
+    "confidence": number (0-100),
+    "required_values": { ... },
+    "optional_values": { ... }
+  }
+]
+
+Intents: ${JSON.stringify(intents, null, 2)}
+Context: ${contextStr}
+`;
+        try {
+            const text = await this.llm.generateContent(prompt);
+            const parsed = JSON.parse(text.replace(/^```json\s*/, '').replace(/```$/, '').trim());
+            const results = [];
+            for (const match of parsed) {
+                if (match.confidence < confidenceThreshold)
+                    continue;
+                const intent = intents.find(i => i.name === match.intentName);
+                if (!intent)
+                    continue;
+                results.push({
+                    intent,
+                    confidence: match.confidence,
+                    required_values: match.required_values,
+                    optional_values: match.optional_values,
+                });
+            }
+            return results;
+        }
+        catch (err) {
+            throw new errors_1.IntentDetectionError('Failed to parse LLM output', { error: err instanceof Error ? err.message : String(err), context: contextStr });
+        }
+    }
+    /**
+     * Detect intent from conversation history
+     * @param history Conversation history
+     * @param intents Available intents
+     * @param confidenceThreshold Minimum confidence threshold (0-100)
+     * @returns Best matched intent or null
+     */
+    async detectFromHistory(history, intents, confidenceThreshold = 70) {
+        // Use last 3 messages to capture context (e.g. slots across turns)
+        const recentHistory = history.slice(-3);
+        const contextStr = recentHistory.map(m => `${m.role}: ${m.content}`).join('\n');
+        const matches = await this.matchIntents(contextStr, intents, confidenceThreshold);
+        return matches.length > 0 ? matches[0] : null;
+    }
+}
+exports.IntentMatcher = IntentMatcher;
+//# sourceMappingURL=IntentMatcher.js.map

package/dist/adapters/intent/IntentMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentMatcher.js","sourceRoot":"","sources":["../../../src/adapters/intent/IntentMatcher.ts"],"names":[],"mappings":";;;AACA,8CAAyD;AAEzD;;GAEG;AACH,MAAa,aAAa;IACtB,YAAoB,GAAgB;QAAhB,QAAG,GAAH,GAAG,CAAa;IAAI,CAAC;IAEzC;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CACd,OAAwB,EACxB,OAAiB,EACjB,sBAA8B,EAAE;QAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEnF,MAAM,MAAM,GAAG;;;;;;;;;;;;oBAYH,mBAAmB;;;;;;;;;;;;WAY5B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;WAChC,UAAU;CACpB,CAAC;QAEM,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,eAAgB,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtF,MAAM,OAAO,GAAoB,EAAE,CAAC;YAEpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,IAAI,KAAK,CAAC,UAAU,GAAG,mBAAmB;oBAAE,SAAS;gBACrD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC9D,IAAI,CAAC,MAAM;oBAAE,SAAS;gBAEtB,OAAO,CAAC,IAAI,CAAC;oBACT,MAAM;oBACN,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,eAAe,EAAE,KAAK,CAAC,eAAe;oBACtC,eAAe,EAAE,KAAK,CAAC,eAAe;iBACzC,CAAC,CAAC;YACP,CAAC;YACD,OAAO,OAAO,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,IAAI,6BAAoB,CAC1B,4BAA4B,EAC5B,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CACnF,CAAC;QACN,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CACnB,OAAkB,EAClB,OAAiB,EACjB,sBAA8B,EAAE;QAEhC,mEAAmE;QACnE,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAElF,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;CACJ;AA7FD,sCA6FC"}

package/dist/adapters/intent/IntentService.d.ts

@@ -0,0 +1,27 @@
+import { IIntentService, IntentResult, Message, Intent, MatchedIntent } from '../../interfaces';
+import { IIntentRepository } from '../../ports/IIntentRepository';
+import { IntentMatcher } from './IntentMatcher';
+/**
+ * Refactored Intent Service with proper separation of concerns
+ * - Uses IIntentRepository for data access
+ * - Uses IntentMatcher for matching logic
+ */
+export declare class IntentService implements IIntentService {
+    private repository;
+    private matcher;
+    private confidenceThreshold;
+    constructor(repository: IIntentRepository, matcher: IntentMatcher, confidenceThreshold?: number);
+    /**
+     * Detect intent from conversation history
+     */
+    detectIntent(history: Message[], systemPrompt: string): Promise<IntentResult>;
+    /**
+     * Upsert multiple intents
+     */
+    upsertIntents(intents: Intent[]): Promise<void>;
+    /**
+     * Match intents against context
+     */
+    matchIntents(context: string | object, confidenceThreshold?: number): Promise<MatchedIntent[]>;
+}
+//# sourceMappingURL=IntentService.d.ts.map

package/dist/adapters/intent/IntentService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentService.d.ts","sourceRoot":"","sources":["../../../src/adapters/intent/IntentService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,cAAc;IAE5C,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,mBAAmB;gBAFnB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,aAAa,EACtB,mBAAmB,GAAE,MAAW;IAG5C;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmCnF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;OAEG;IACG,YAAY,CACd,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,mBAAmB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC;CAQ9B"}

package/dist/adapters/intent/IntentService.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentService = void 0;
+/**
+ * Refactored Intent Service with proper separation of concerns
+ * - Uses IIntentRepository for data access
+ * - Uses IntentMatcher for matching logic
+ */
+class IntentService {
+    constructor(repository, matcher, confidenceThreshold = 70) {
+        this.repository = repository;
+        this.matcher = matcher;
+        this.confidenceThreshold = confidenceThreshold;
+    }
+    /**
+     * Detect intent from conversation history
+     */
+    async detectIntent(history, systemPrompt) {
+        const allIntents = await this.repository.getAllIntents();
+        if (allIntents.length === 0) {
+            return {
+                intentName: null,
+                confidence: 0,
+                payload: {}
+            };
+        }
+        const match = await this.matcher.detectFromHistory(history, allIntents, this.confidenceThreshold);
+        if (match) {
+            return {
+                intentName: match.intent.name,
+                confidence: match.confidence / 100, // Convert 0-100 to 0-1
+                payload: {
+                    ...match.required_values,
+                    ...match.optional_values
+                }
+            };
+        }
+        return {
+            intentName: null,
+            confidence: 0,
+            payload: {}
+        };
+    }
+    /**
+     * Upsert multiple intents
+     */
+    async upsertIntents(intents) {
+        return this.repository.upsertIntents(intents);
+    }
+    /**
+     * Match intents against context
+     */
+    async matchIntents(context, confidenceThreshold) {
+        const allIntents = await this.repository.getAllIntents();
+        return this.matcher.matchIntents(context, allIntents, confidenceThreshold ?? this.confidenceThreshold);
+    }
+}
+exports.IntentService = IntentService;
+//# sourceMappingURL=IntentService.js.map

package/dist/adapters/intent/IntentService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentService.js","sourceRoot":"","sources":["../../../src/adapters/intent/IntentService.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AACH,MAAa,aAAa;IACtB,YACY,UAA6B,EAC7B,OAAsB,EACtB,sBAA8B,EAAE;QAFhC,eAAU,GAAV,UAAU,CAAmB;QAC7B,YAAO,GAAP,OAAO,CAAe;QACtB,wBAAmB,GAAnB,mBAAmB,CAAa;IACxC,CAAC;IAEL;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAkB,EAAE,YAAoB;QACvD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QAEzD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACH,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,EAAE;aACd,CAAC;QACN,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAC9C,OAAO,EACP,UAAU,EACV,IAAI,CAAC,mBAAmB,CAC3B,CAAC;QAEF,IAAI,KAAK,EAAE,CAAC;YACR,OAAO;gBACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;gBAC7B,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,GAAG,EAAE,uBAAuB;gBAC3D,OAAO,EAAE;oBACL,GAAG,KAAK,CAAC,eAAe;oBACxB,GAAG,KAAK,CAAC,eAAe;iBAC3B;aACJ,CAAC;QACN,CAAC;QAED,OAAO;YACH,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,EAAE;SACd,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAiB;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CACd,OAAwB,EACxB,mBAA4B;QAE5B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAC5B,OAAO,EACP,UAAU,EACV,mBAAmB,IAAI,IAAI,CAAC,mBAAmB,CAClD,CAAC;IACN,CAAC;CACJ;AAlED,sCAkEC"}

package/dist/adapters/intent/MockIntentAdapter.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockIntentAdapter = void 0;
+class MockIntentAdapter {
+    async detectIntent(history, systemPrompt) {
+        const lastMsg = history[history.length - 1].content.toLowerCase();
+        // Simple keyword detection for demo
+        if (lastMsg.includes('book') || lastMsg.includes('flight') || lastMsg.includes('paris')) {
+            return {
+                intentName: 'USER_WANTS_FLIGHT',
+                confidence: 0.95,
+                payload: { destination: 'Paris' }
+            };
+        }
+        if (lastMsg.includes('morning') || lastMsg.includes('10 am')) {
+            return {
+                intentName: 'USER_SELECT_FLIGHT',
+                confidence: 0.9,
+                payload: { chosen_flight: 'AC123 (10:00 AM)' }
+            };
+        }
+        return {
+            intentName: null,
+            confidence: 0,
+            payload: {}
+        };
+    }
+}
+exports.MockIntentAdapter = MockIntentAdapter;

package/dist/adapters/llm/GeminiLLMAdapter.d.ts

@@ -0,0 +1,10 @@
+import { ILLMAdapter, LLMResponse, Message } from '../../interfaces';
+export declare class GeminiLLMAdapter implements ILLMAdapter {
+    private genAI;
+    private model;
+    private embeddingModel;
+    constructor(apiKey: string);
+    generateResponse(systemPrompt: string, history: Message[]): Promise<LLMResponse>;
+    generateContent(prompt: string): Promise<string>;
+}
+//# sourceMappingURL=GeminiLLMAdapter.d.ts.map

package/dist/adapters/llm/GeminiLLMAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiLLMAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/GeminiLLMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAQ,MAAM,kBAAkB,CAAC;AAE3E,qBAAa,gBAAiB,YAAW,WAAW;IAChD,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,cAAc,CAAM;gBAEhB,MAAM,EAAE,MAAM;IAKpB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAqGhF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAIzD"}