@windagency/valora 2.0.1

package/dist/services/idempotency-store.service.js

@@ -0,0 +1,418 @@
+/**
+ * Idempotency Store Service
+ *
+ * Provides idempotency key validation and result caching for tool execution.
+ * Ensures that duplicate tool calls with the same parameters return cached results
+ * instead of re-executing, preventing unintended side effects.
+ *
+ */
+import { createHash } from 'crypto';
+import { existsSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { getLogger } from '../output/logger.js';
+import { join } from 'path';
+import { isIdempotentTool } from '../types/idempotency.types.js';
+import { formatErrorMessage } from '../utils/error-handler.js';
+import { getFileLockManager } from '../utils/file-lock.js';
+import { getRuntimeDataDir } from '../utils/paths.js';
+const logger = getLogger();
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    cleanup_interval_ms: 5 * 60 * 1000, // 5 minutes
+    default_ttl_ms: 60 * 60 * 1000, // 1 hour
+    max_records: 10000,
+    store_dir: join(getRuntimeDataDir(), 'idempotency')
+};
+export class IdempotencyStoreService {
+    cleanupTimer = null;
+    config;
+    lockerId = `idempotency-${process.pid}`;
+    lockManager = getFileLockManager();
+    recordCount = 0;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.ensureStoreDirectory();
+        this.startCleanupTimer();
+    }
+    /**
+     * Generate an idempotency key from a tool call
+     * The key is a hash of the tool name and sorted arguments
+     */
+    generateKey(toolCall, sessionId) {
+        const keyData = {
+            args: this.sortObject(toolCall.arguments),
+            name: toolCall.name,
+            session_id: sessionId
+        };
+        const hash = createHash('sha256').update(JSON.stringify(keyData)).digest('hex').substring(0, 32);
+        return `${toolCall.name}-${hash}`;
+    }
+    /**
+     * Generate a hash of the arguments for verification
+     */
+    generateArgsHash(args) {
+        return createHash('sha256')
+            .update(JSON.stringify(this.sortObject(args)))
+            .digest('hex')
+            .substring(0, 16);
+    }
+    /**
+     * Check if a tool call has a cached result
+     * Returns the cached result if found and not expired
+     */
+    async check(toolCall, options) {
+        const key = this.generateKey(toolCall, options?.session_id);
+        // Skip check for non-idempotent tools
+        if (!isIdempotentTool(toolCall.name)) {
+            return { found: false, key };
+        }
+        // Skip if force_execute is set
+        if (options?.force_execute) {
+            logger.debug('Idempotency check skipped (force_execute)', { key });
+            return { found: false, key };
+        }
+        const recordPath = this.getRecordPath(key);
+        try {
+            const record = await this.lockManager.readWithLock(recordPath, this.lockerId, {
+                retries: 2,
+                timeout_ms: 2000
+            });
+            if (!record) {
+                return { found: false, key };
+            }
+            // Check if expired
+            if (new Date(record.expires_at) < new Date()) {
+                logger.debug('Idempotency record expired', { key });
+                this.delete(key);
+                return { found: false, key };
+            }
+            // Verify args hash matches (defense against hash collisions)
+            const currentArgsHash = this.generateArgsHash(toolCall.arguments);
+            if (record.args_hash !== currentArgsHash) {
+                logger.warn('Idempotency key collision detected', {
+                    current_hash: currentArgsHash,
+                    key,
+                    stored_hash: record.args_hash
+                });
+                return { found: false, key };
+            }
+            logger.info('Idempotency cache hit', {
+                age_ms: Date.now() - new Date(record.created_at).getTime(),
+                key,
+                tool: toolCall.name
+            });
+            return { found: true, key, record };
+        }
+        catch (error) {
+            logger.debug('Idempotency check failed', {
+                error: formatErrorMessage(error),
+                key
+            });
+            return { found: false, key };
+        }
+    }
+    /**
+     * Store a result for an idempotency key
+     */
+    async store(toolCall, result, options) {
+        // Only store results for idempotent tools
+        if (!isIdempotentTool(toolCall.name)) {
+            return;
+        }
+        const key = this.generateKey(toolCall, options?.session_id);
+        const ttl = options?.ttl_ms ?? this.config.default_ttl_ms;
+        const record = {
+            args_hash: this.generateArgsHash(toolCall.arguments),
+            created_at: new Date().toISOString(),
+            expires_at: new Date(Date.now() + ttl).toISOString(),
+            key,
+            result,
+            session_id: options?.session_id,
+            tool_name: toolCall.name
+        };
+        const recordPath = this.getRecordPath(key);
+        try {
+            await this.lockManager.writeWithLock(recordPath, record, this.lockerId, {
+                pretty: false,
+                retries: 2,
+                timeout_ms: 2000
+            });
+            this.recordCount++;
+            logger.debug('Idempotency record stored', {
+                key,
+                tool: toolCall.name,
+                ttl_ms: ttl
+            });
+            // Trigger cleanup if we exceed max records
+            if (this.recordCount > this.config.max_records) {
+                this.cleanup().catch(() => {
+                    // Cleanup errors are non-fatal
+                });
+            }
+        }
+        catch (error) {
+            logger.warn('Failed to store idempotency record', {
+                error: formatErrorMessage(error),
+                key
+            });
+            // Non-fatal - execution continues without caching
+        }
+    }
+    /**
+     * Delete an idempotency record
+     */
+    delete(key) {
+        const recordPath = this.getRecordPath(key);
+        try {
+            if (existsSync(recordPath)) {
+                unlinkSync(recordPath);
+                this.recordCount = Math.max(0, this.recordCount - 1);
+                logger.debug('Idempotency record deleted', { key });
+            }
+        }
+        catch (error) {
+            logger.debug('Failed to delete idempotency record', {
+                error: formatErrorMessage(error),
+                key
+            });
+        }
+    }
+    /**
+     * Invalidate all records for a specific tool
+     */
+    invalidateTool(toolName) {
+        let invalidated = 0;
+        try {
+            const files = readdirSync(this.config.store_dir);
+            for (const file of files) {
+                if (file.startsWith(`${toolName}-`) && file.endsWith('.json')) {
+                    const key = file.replace('.json', '');
+                    this.delete(key);
+                    invalidated++;
+                }
+            }
+            logger.info('Idempotency records invalidated', { count: invalidated, toolName });
+        }
+        catch (error) {
+            logger.warn('Failed to invalidate tool records', {
+                error: formatErrorMessage(error),
+                toolName
+            });
+        }
+        return invalidated;
+    }
+    /**
+     * Invalidate all records for a session
+     */
+    async invalidateSession(sessionId) {
+        let invalidated = 0;
+        try {
+            const files = readdirSync(this.config.store_dir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const recordPath = join(this.config.store_dir, file);
+                try {
+                    const record = await this.lockManager.readWithLock(recordPath, this.lockerId, {
+                        retries: 1,
+                        timeout_ms: 1000
+                    });
+                    if (record?.session_id === sessionId) {
+                        this.delete(record.key);
+                        invalidated++;
+                    }
+                }
+                catch {
+                    // Skip records we can't read
+                }
+            }
+            logger.info('Session idempotency records invalidated', { count: invalidated, sessionId });
+        }
+        catch (error) {
+            logger.warn('Failed to invalidate session records', {
+                error: formatErrorMessage(error),
+                sessionId
+            });
+        }
+        return invalidated;
+    }
+    /**
+     * Clean up expired records
+     */
+    async cleanup() {
+        let cleaned = 0;
+        const now = new Date();
+        try {
+            const files = readdirSync(this.config.store_dir);
+            for (const file of files) {
+                if (!file.endsWith('.json') || file.endsWith('.lock'))
+                    continue;
+                const recordPath = join(this.config.store_dir, file);
+                const wasDeleted = await this.cleanupExpiredRecord(recordPath, now);
+                if (wasDeleted)
+                    cleaned++;
+            }
+            this.updateRecordCount();
+            if (cleaned > 0) {
+                logger.debug('Idempotency cleanup completed', { cleaned, remaining: this.recordCount });
+            }
+            await this.lockManager.cleanupExpiredLocks(this.config.store_dir);
+        }
+        catch (error) {
+            logger.debug('Idempotency cleanup failed', {
+                error: formatErrorMessage(error)
+            });
+        }
+        return cleaned;
+    }
+    /**
+     * Clean up a single expired record
+     */
+    async cleanupExpiredRecord(recordPath, now) {
+        try {
+            const record = await this.lockManager.readWithLock(recordPath, this.lockerId, {
+                retries: 1,
+                timeout_ms: 1000
+            });
+            if (record && new Date(record.expires_at) < now) {
+                this.delete(record.key);
+                return true;
+            }
+            return false;
+        }
+        catch {
+            // Skip files we can't read (may be locked or temporarily unavailable)
+            // Only delete files we can confirm are expired
+            return false;
+        }
+    }
+    /**
+     * Update the record count from the store directory
+     */
+    updateRecordCount() {
+        this.recordCount = readdirSync(this.config.store_dir).filter((f) => f.endsWith('.json') && !f.endsWith('.lock')).length;
+    }
+    /**
+     * Clear all idempotency records
+     */
+    clear() {
+        let cleared = 0;
+        try {
+            const files = readdirSync(this.config.store_dir);
+            for (const file of files) {
+                if (file.endsWith('.json')) {
+                    try {
+                        unlinkSync(join(this.config.store_dir, file));
+                        cleared++;
+                    }
+                    catch {
+                        // Ignore
+                    }
+                }
+            }
+            this.recordCount = 0;
+            logger.info('Idempotency store cleared', { count: cleared });
+        }
+        catch (error) {
+            logger.warn('Failed to clear idempotency store', {
+                error: formatErrorMessage(error)
+            });
+        }
+        return cleared;
+    }
+    /**
+     * Get store statistics
+     */
+    getStats() {
+        return {
+            max_records: this.config.max_records,
+            record_count: this.recordCount,
+            store_dir: this.config.store_dir
+        };
+    }
+    /**
+     * Stop the cleanup timer (for graceful shutdown)
+     */
+    stop() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /**
+     * Ensure the store directory exists
+     */
+    ensureStoreDirectory() {
+        if (!existsSync(this.config.store_dir)) {
+            mkdirSync(this.config.store_dir, { recursive: true });
+        }
+        // Count existing records
+        try {
+            this.recordCount = readdirSync(this.config.store_dir).filter((f) => f.endsWith('.json') && !f.endsWith('.lock')).length;
+        }
+        catch {
+            this.recordCount = 0;
+        }
+    }
+    /**
+     * Start the periodic cleanup timer
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup().catch(() => {
+                // Cleanup errors are non-fatal
+            });
+        }, this.config.cleanup_interval_ms);
+        // Don't keep the process alive for cleanup
+        this.cleanupTimer.unref();
+    }
+    /**
+     * Get the file path for a record
+     */
+    getRecordPath(key) {
+        return join(this.config.store_dir, `${key}.json`);
+    }
+    /**
+     * Sort an object's keys recursively for consistent hashing
+     */
+    sortObject(obj) {
+        if (typeof obj !== 'object' || obj === null) {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            const sortedArray = obj.map((item) => typeof item === 'object' && item !== null ? this.sortObject(item) : item);
+            return sortedArray;
+        }
+        const sorted = {};
+        for (const key of Object.keys(obj).sort()) {
+            const value = obj[key];
+            sorted[key] =
+                typeof value === 'object' && value !== null ? this.sortObject(value) : value;
+        }
+        return sorted;
+    }
+}
+/**
+ * Singleton instance
+ */
+let idempotencyStore = null;
+/**
+ * Get the global idempotency store instance
+ */
+export function getIdempotencyStore(config) {
+    if (!idempotencyStore || config) {
+        idempotencyStore = new IdempotencyStoreService(config);
+    }
+    return idempotencyStore;
+}
+/**
+ * Reset the singleton (for testing)
+ */
+export function resetIdempotencyStore() {
+    if (idempotencyStore) {
+        idempotencyStore.stop();
+        idempotencyStore = null;
+    }
+}
+//# sourceMappingURL=idempotency-store.service.js.map

package/dist/services/idempotency-store.service.js.map

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

package/dist/services/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Services module exports
+ */
+export { AgentCapabilityMatcherService } from './agent-capability-matcher.service.js';
+export { AgentCapabilityRegistryService } from './agent-capability-registry.service.js';
+export { AgentSelectionAnalyticsService } from './agent-selection-analytics.service.js';
+export { ContextAnalyzerService } from './context-analyzer.service.js';
+export { DocumentDetectorService } from './document-detector.service.js';
+export { DocumentPathResolverService } from './document-path-resolver.service.js';
+export { DocumentTemplateService } from './document-template.service.js';
+export { DocumentWriterService } from './document-writer.service.js';
+export { DynamicAgentResolverService } from './dynamic-agent-resolver.service.js';
+export { type ConfirmStashFn, createGitStashProtection, getGitStashProtection, GitStashProtectionService } from './git-stash-protection.service.js';
+export { getIdempotencyStore, IdempotencyStoreService, resetIdempotencyStore } from './idempotency-store.service.js';
+export { TaskClassifierService } from './task-classifier.service.js';
+export { DomainKeywordRegistry, getDomainKeywordRegistry, resetDomainKeywordRegistry } from '../utils/domain-keyword-registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EACN,KAAK,cAAc,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACN,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,+BAA+B,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,17 @@
+/**
+ * Services module exports
+ */
+export { AgentCapabilityMatcherService } from './agent-capability-matcher.service.js';
+export { AgentCapabilityRegistryService } from './agent-capability-registry.service.js';
+export { AgentSelectionAnalyticsService } from './agent-selection-analytics.service.js';
+export { ContextAnalyzerService } from './context-analyzer.service.js';
+export { DocumentDetectorService } from './document-detector.service.js';
+export { DocumentPathResolverService } from './document-path-resolver.service.js';
+export { DocumentTemplateService } from './document-template.service.js';
+export { DocumentWriterService } from './document-writer.service.js';
+export { DynamicAgentResolverService } from './dynamic-agent-resolver.service.js';
+export { createGitStashProtection, getGitStashProtection, GitStashProtectionService } from './git-stash-protection.service.js';
+export { getIdempotencyStore, IdempotencyStoreService, resetIdempotencyStore } from './idempotency-store.service.js';
+export { TaskClassifierService } from './task-classifier.service.js';
+export { DomainKeywordRegistry, getDomainKeywordRegistry, resetDomainKeywordRegistry } from '../utils/domain-keyword-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAEN,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACN,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,+BAA+B,CAAC"}

package/dist/services/task-classifier.service.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Task Classifier Service
+ *
+ * Analyses task descriptions and classifies implementation requirements
+ * to determine the appropriate agent specialisation.
+ */
+import type { TaskClassification, TaskContext } from '../types/agent.types.js';
+import { type DomainKeywordRegistry } from '../utils/domain-keyword-registry.js';
+export declare class TaskClassifierService {
+    private readonly keywordRegistry;
+    private readonly logger;
+    constructor(keywordRegistry?: DomainKeywordRegistry);
+    /**
+     * Classify a task based on its description and context
+     */
+    classifyTask(taskContext: TaskContext): TaskClassification;
+    /**
+     * Extract keywords from task description
+     */
+    private extractKeywords;
+    /**
+     * Identify patterns from extracted keywords
+     */
+    private identifyPatterns;
+    /**
+     * Determine primary domain based on patterns and context
+     */
+    private determinePrimaryDomain;
+    /**
+     * Detect domain from affected files
+     */
+    private detectDomainFromFiles;
+    /**
+     * Calculate task complexity
+     */
+    private calculateComplexity;
+    /**
+     * Get suggested agents for a domain
+     */
+    private getSuggestedAgents;
+}
+//# sourceMappingURL=task-classifier.service.d.ts.map

package/dist/services/task-classifier.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-classifier.service.d.ts","sourceRoot":"","sources":["../../src/services/task-classifier.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAGrF,OAAO,EAAE,KAAK,qBAAqB,EAA4B,MAAM,+BAA+B,CAAC;AAErG,qBAAa,qBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,eAAe,CAAC,EAAE,qBAAqB;IAInD;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,kBAAkB;IAwC1D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuD9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqD7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAuB1B"}