@dcyfr/ai 1.0.0 → 1.0.2

package/dist/ai/agents/agent-router.js

@@ -0,0 +1,375 @@
+/**
+ * Agent Router - Task routing and delegation
+ *
+ * Routes tasks to appropriate agents based on patterns, categories, and conditions.
+ * Supports delegation between agents and fallback chains.
+ *
+ * @module @dcyfr/ai/agents/agent-router
+ * @example
+ * ```typescript
+ * import { AgentRouter } from '@dcyfr/ai/agents/agent-router';
+ * import { AgentRegistry } from '@dcyfr/ai/agents/agent-registry';
+ *
+ * const registry = new AgentRegistry();
+ * const router = new AgentRouter(registry, {
+ *   defaultAgent: 'fullstack-developer',
+ *   delegationEnabled: true,
+ * });
+ *
+ * // Route a task
+ * const result = await router.route({
+ *   description: 'Fix the failing tests',
+ *   phase: 'implementation',
+ *   filesInProgress: ['src/app.test.ts'],
+ * });
+ *
+ * console.log(`Routed to: ${result.agent.manifest.name}`);
+ * ```
+ */
+/**
+ * Default routing rules based on task patterns
+ */
+const DEFAULT_ROUTING_RULES = [
+    // Testing patterns
+    {
+        pattern: /test|spec|jest|vitest|coverage|assertion/i,
+        agent: 'test-engineer',
+        priority: 10,
+    },
+    // Security patterns
+    {
+        pattern: /security|auth|vulnerab|owasp|xss|injection|encrypt/i,
+        agent: 'security-engineer',
+        priority: 10,
+    },
+    // Performance patterns
+    {
+        pattern: /performance|optimize|speed|memory|cpu|cache|lazy|bundle/i,
+        agent: 'performance-profiler',
+        priority: 10,
+    },
+    // Architecture patterns
+    {
+        pattern: /architect|design|refactor|pattern|structure|modular/i,
+        agent: 'architecture-reviewer',
+        priority: 20,
+    },
+    // Database patterns
+    {
+        pattern: /database|sql|postgres|mongo|redis|query|migration/i,
+        agent: 'database-architect',
+        priority: 20,
+    },
+    // DevOps patterns
+    {
+        pattern: /deploy|ci|cd|docker|kubernetes|aws|azure|infra/i,
+        agent: 'devops-engineer',
+        priority: 20,
+    },
+    // Data patterns
+    {
+        pattern: /data|analysis|ml|machine learning|model|dataset/i,
+        agent: 'data-scientist',
+        priority: 20,
+    },
+    // Documentation patterns
+    {
+        pattern: /document|readme|api doc|jsdoc|typedoc/i,
+        agent: 'technical-writer',
+        priority: 30,
+    },
+    // Research patterns
+    {
+        pattern: /research|investigate|explore|understand|analyze/i,
+        agent: 'research-orchestrator',
+        priority: 30,
+    },
+    // Frontend patterns
+    {
+        pattern: /frontend|react|vue|angular|css|style|ui|component/i,
+        agent: 'frontend-developer',
+        priority: 40,
+    },
+    // Backend patterns
+    {
+        pattern: /backend|api|server|endpoint|route|middleware/i,
+        agent: 'backend-architect',
+        priority: 40,
+    },
+    // Default development
+    {
+        pattern: /fix|bug|implement|feature|code|develop/i,
+        agent: 'fullstack-developer',
+        priority: 50,
+    },
+];
+/**
+ * Default router configuration
+ */
+const DEFAULT_CONFIG = {
+    defaultAgent: 'fullstack-developer',
+    routingRules: DEFAULT_ROUTING_RULES,
+    delegationEnabled: true,
+    maxDelegationDepth: 3,
+};
+/**
+ * Agent Router - routes tasks to appropriate agents
+ */
+export class AgentRouter {
+    registry;
+    config;
+    delegationDepth = 0;
+    constructor(registry, config = {}) {
+        this.registry = registry;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Route a task to the most appropriate agent
+     */
+    async route(task) {
+        // Find matching rules sorted by priority
+        const matchedRules = this.findMatchingRules(task);
+        // Try each matched rule in priority order
+        for (const rule of matchedRules) {
+            const agent = this.registry.resolveAgent(rule.agent);
+            if (agent) {
+                const fallbacks = this.findFallbacks(agent, task);
+                return {
+                    agent,
+                    matchedRule: rule,
+                    fallbacks,
+                    confidence: this.calculateConfidence(rule, task),
+                };
+            }
+        }
+        // Fall back to default agent
+        const defaultAgent = this.registry.resolveAgent(this.config.defaultAgent);
+        if (defaultAgent) {
+            return {
+                agent: defaultAgent,
+                fallbacks: [],
+                confidence: 0.5,
+            };
+        }
+        throw new Error(`No agent found for task and default agent '${this.config.defaultAgent}' not available`);
+    }
+    /**
+     * Route with custom rules (merges with default rules)
+     */
+    async routeWithRules(task, customRules) {
+        const originalRules = this.config.routingRules;
+        this.config.routingRules = [...customRules, ...originalRules];
+        try {
+            return await this.route(task);
+        }
+        finally {
+            this.config.routingRules = originalRules;
+        }
+    }
+    /**
+     * Delegate task to another agent
+     */
+    async delegate(fromAgent, toAgentName, task) {
+        if (!this.config.delegationEnabled) {
+            throw new Error('Delegation is disabled');
+        }
+        if (this.config.maxDelegationDepth &&
+            this.delegationDepth >= this.config.maxDelegationDepth) {
+            throw new Error(`Maximum delegation depth (${this.config.maxDelegationDepth}) exceeded`);
+        }
+        // Check if delegation is allowed
+        if (fromAgent.manifest.delegatesTo &&
+            !fromAgent.manifest.delegatesTo.includes(toAgentName)) {
+            throw new Error(`Agent '${fromAgent.manifest.name}' cannot delegate to '${toAgentName}'`);
+        }
+        const toAgent = this.registry.resolveAgent(toAgentName);
+        if (!toAgent) {
+            throw new Error(`Delegation target agent '${toAgentName}' not found`);
+        }
+        this.delegationDepth++;
+        return toAgent;
+    }
+    /**
+     * Execute task with automatic fallback
+     */
+    async executeWithFallback(context, primaryAgent, fallbacks) {
+        const agents = [primaryAgent, ...fallbacks];
+        for (let i = 0; i < agents.length; i++) {
+            const agent = agents[i];
+            const startTime = Date.now();
+            try {
+                // Call onBeforeExecute hook
+                if (agent.onBeforeExecute) {
+                    await agent.onBeforeExecute(context);
+                }
+                // Execute agent (placeholder - actual execution depends on integration)
+                // In real usage, this would call the AI provider with the agent's prompt
+                const result = {
+                    success: true,
+                    agentName: agent.manifest.name,
+                    executionTime: Date.now() - startTime,
+                    fallbackUsed: i > 0,
+                    originalAgent: i > 0 ? primaryAgent.manifest.name : undefined,
+                    filesModified: [],
+                    violations: [],
+                    warnings: [],
+                };
+                // Call onAfterExecute hook
+                if (agent.onAfterExecute) {
+                    await agent.onAfterExecute(context, result);
+                }
+                return result;
+            }
+            catch (error) {
+                // Call onError hook
+                if (agent.onError) {
+                    await agent.onError(error, context);
+                }
+                // If this was the last agent, throw the error
+                if (i === agents.length - 1) {
+                    return {
+                        success: false,
+                        agentName: agent.manifest.name,
+                        executionTime: Date.now() - startTime,
+                        fallbackUsed: i > 0,
+                        originalAgent: i > 0 ? primaryAgent.manifest.name : undefined,
+                        filesModified: [],
+                        violations: [],
+                        warnings: [],
+                        error: error,
+                    };
+                }
+                // Try next fallback
+                console.warn(`⚠️  Agent '${agent.manifest.name}' failed, trying fallback...`);
+            }
+        }
+        // Should never reach here
+        throw new Error('No agents available for execution');
+    }
+    /**
+     * Add a routing rule
+     */
+    addRule(rule) {
+        this.config.routingRules.push(rule);
+        // Re-sort by priority
+        this.config.routingRules.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Remove a routing rule by pattern
+     */
+    removeRule(pattern) {
+        const patternStr = pattern.toString();
+        const index = this.config.routingRules.findIndex((r) => r.pattern.toString() === patternStr);
+        if (index !== -1) {
+            this.config.routingRules.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get all routing rules
+     */
+    getRules() {
+        return [...this.config.routingRules];
+    }
+    /**
+     * Reset delegation depth
+     */
+    resetDelegation() {
+        this.delegationDepth = 0;
+    }
+    /**
+     * Get current delegation depth
+     */
+    getDelegationDepth() {
+        return this.delegationDepth;
+    }
+    /**
+     * Find matching routing rules for a task
+     */
+    findMatchingRules(task) {
+        const matches = [];
+        for (const rule of this.config.routingRules) {
+            // Check pattern match
+            const pattern = rule.pattern instanceof RegExp
+                ? rule.pattern
+                : new RegExp(rule.pattern, 'i');
+            const textToMatch = [
+                task.description,
+                ...task.filesInProgress,
+                task.phase,
+            ].join(' ');
+            if (pattern.test(textToMatch)) {
+                // Check condition if present
+                if (rule.condition && !rule.condition(task)) {
+                    continue;
+                }
+                matches.push(rule);
+            }
+        }
+        // Sort by priority (lower = higher priority)
+        return matches.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Find fallback agents for a primary agent
+     */
+    findFallbacks(primaryAgent, task) {
+        const fallbacks = [];
+        const seen = new Set([primaryAgent.manifest.name]);
+        // Add agents from delegatesTo list
+        if (primaryAgent.manifest.delegatesTo) {
+            for (const name of primaryAgent.manifest.delegatesTo) {
+                if (seen.has(name))
+                    continue;
+                const agent = this.registry.resolveAgent(name);
+                if (agent) {
+                    fallbacks.push(agent);
+                    seen.add(name);
+                }
+            }
+        }
+        // Add agents from same category
+        const categoryAgents = this.registry.getAgentsByCategory(primaryAgent.manifest.category);
+        for (const loaded of categoryAgents) {
+            if (seen.has(loaded.name))
+                continue;
+            if (loaded.enabled) {
+                fallbacks.push(loaded.agent);
+                seen.add(loaded.name);
+            }
+        }
+        // Limit fallbacks to prevent infinite chains
+        return fallbacks.slice(0, 3);
+    }
+    /**
+     * Calculate confidence score for a routing match
+     */
+    calculateConfidence(rule, task) {
+        // Base confidence from priority (lower priority = higher confidence)
+        const priorityConfidence = Math.max(0, 1 - rule.priority / 100);
+        // Boost confidence if condition matched
+        const conditionBoost = rule.condition ? 0.1 : 0;
+        // Calculate final confidence (0-1)
+        return Math.min(1, priorityConfidence + conditionBoost);
+    }
+}
+/**
+ * Global agent router instance
+ */
+let globalRouter = null;
+/**
+ * Get or create global agent router
+ */
+export function getGlobalAgentRouter(registry, config) {
+    if (!globalRouter) {
+        globalRouter = new AgentRouter(registry, config);
+    }
+    return globalRouter;
+}
+/**
+ * Reset global agent router
+ */
+export function resetGlobalAgentRouter() {
+    globalRouter = null;
+}
+//# sourceMappingURL=agent-router.js.map

package/dist/ai/agents/agent-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-router.js","sourceRoot":"","sources":["../../../packages/ai/agents/agent-router.ts"],"names":[],"mappings":"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"}

package/dist/ai/agents/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agent Module - Exports for the agent framework
+ *
+ * @module @dcyfr/ai/agents
+ */
+export type { AgentCategory, AgentTier, AgentModel, AgentPermissionMode, AgentQualityGate, AgentProactiveTrigger, AgentSkill, AgentManifest, AgentHooks, Agent, LoadedAgent, AgentExecutionContext, AgentExecutionResult, AgentViolation, AgentRoutingRule, AgentRoutingResult, AgentRegistryConfig, AgentLoaderConfig, AgentRouterConfig, } from './types';
+export { AgentLoader, AgentLoadError, AgentValidationError, getGlobalAgentLoader, resetGlobalAgentLoader, } from './agent-loader';
+export { AgentRegistry, getGlobalAgentRegistry, resetGlobalAgentRegistry, } from './agent-registry';
+export { AgentRouter, getGlobalAgentRouter, resetGlobalAgentRouter, } from './agent-router';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,UAAU,EACV,KAAK,EACL,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/ai/agents/index.js

@@ -0,0 +1,12 @@
+/**
+ * Agent Module - Exports for the agent framework
+ *
+ * @module @dcyfr/ai/agents
+ */
+// Agent Loader exports
+export { AgentLoader, AgentLoadError, AgentValidationError, getGlobalAgentLoader, resetGlobalAgentLoader, } from './agent-loader';
+// Agent Registry exports
+export { AgentRegistry, getGlobalAgentRegistry, resetGlobalAgentRegistry, } from './agent-registry';
+// Agent Router exports
+export { AgentRouter, getGlobalAgentRouter, resetGlobalAgentRouter, } from './agent-router';
+//# sourceMappingURL=index.js.map

package/dist/ai/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,yBAAyB;AACzB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/ai/agents/types.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Agent Type Definitions for DCYFR AI Framework
+ *
+ * Defines the interfaces and types for the agent system including manifests,
+ * categories, tiers, and execution contexts.
+ *
+ * @module @dcyfr/ai/agents/types
+ */
+import type { ValidationSeverity, TaskContext } from '../types';
+/**
+ * Agent category classification
+ * Used for organizing and routing agents by their specialization
+ */
+export type AgentCategory = 'core' | 'development' | 'architecture' | 'testing' | 'security' | 'performance' | 'content' | 'devops' | 'data' | 'research' | 'specialized';
+/**
+ * Agent tier for OPSEC and loading priority
+ * - public: Available in @dcyfr/ai (npm)
+ * - private: Available in @dcyfr/agents (git+ssh)
+ * - project: Project-specific overrides
+ */
+export type AgentTier = 'public' | 'private' | 'project';
+/**
+ * Model preference for agent execution
+ */
+export type AgentModel = 'haiku' | 'sonnet' | 'opus';
+/**
+ * Permission mode for agent actions
+ */
+export type AgentPermissionMode = 'readonly' | 'acceptEdits' | 'full';
+/**
+ * Quality gate definition for agent enforcement
+ */
+export interface AgentQualityGate {
+    name: string;
+    threshold: number;
+    metric: string;
+    failureMode: 'error' | 'warn' | 'skip';
+}
+/**
+ * Proactive trigger for agent activation
+ */
+export interface AgentProactiveTrigger {
+    /** Pattern to match (string or regex pattern string) */
+    pattern: string;
+    /** Action to take when triggered */
+    action: 'warn' | 'block' | 'fix' | 'suggest';
+    /** Message to display */
+    message: string;
+    /** Priority (lower = higher priority) */
+    priority?: number;
+}
+/**
+ * Agent skill reference
+ */
+export interface AgentSkill {
+    name: string;
+    path?: string;
+    required?: boolean;
+}
+/**
+ * Agent manifest - complete agent definition
+ */
+export interface AgentManifest {
+    /** Unique agent identifier */
+    name: string;
+    /** Version following semver */
+    version: string;
+    /** Human-readable description */
+    description: string;
+    /** Agent category for routing */
+    category: AgentCategory;
+    /** Distribution tier */
+    tier: AgentTier;
+    /** Preferred model */
+    model: AgentModel;
+    /** Permission level */
+    permissionMode: AgentPermissionMode;
+    /** Tools the agent can use */
+    tools: string[];
+    /** Agents this agent can delegate to */
+    delegatesTo?: string[];
+    /** Agents that delegate to this one */
+    delegatedFrom?: string[];
+    /** Proactive triggers */
+    proactiveTriggers?: AgentProactiveTrigger[];
+    /** Quality gates to enforce */
+    qualityGates?: AgentQualityGate[];
+    /** Skills this agent uses */
+    skills?: AgentSkill[];
+    /** Author information */
+    author?: string;
+    /** License */
+    license?: string;
+    /** Custom configuration schema */
+    configSchema?: Record<string, unknown>;
+    /** Tags for filtering/searching */
+    tags?: string[];
+}
+/**
+ * Agent lifecycle hooks
+ */
+export interface AgentHooks {
+    /** Called when agent is loaded */
+    onLoad?: () => void | Promise<void>;
+    /** Called when agent is unloaded */
+    onUnload?: () => void | Promise<void>;
+    /** Called before agent executes */
+    onBeforeExecute?: (context: AgentExecutionContext) => void | Promise<void>;
+    /** Called after agent executes */
+    onAfterExecute?: (context: AgentExecutionContext, result: AgentExecutionResult) => void | Promise<void>;
+    /** Called when agent encounters an error */
+    onError?: (error: Error, context: AgentExecutionContext) => void | Promise<void>;
+}
+/**
+ * Complete agent definition
+ */
+export interface Agent extends AgentHooks {
+    /** Agent manifest */
+    manifest: AgentManifest;
+    /** System prompt for the agent */
+    systemPrompt?: string;
+    /** Instructions (markdown content) */
+    instructions?: string;
+}
+/**
+ * Loaded agent wrapper with metadata
+ */
+export interface LoadedAgent {
+    name: string;
+    manifest: AgentManifest;
+    agent: Agent;
+    tier: AgentTier;
+    source: string;
+    loaded: Date;
+    enabled: boolean;
+}
+/**
+ * Agent execution context
+ */
+export interface AgentExecutionContext {
+    /** Task to execute */
+    task: TaskContext;
+    /** Agent configuration */
+    config: Record<string, unknown>;
+    /** Working directory */
+    workingDirectory: string;
+    /** Files in scope */
+    files: string[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Agent execution result
+ */
+export interface AgentExecutionResult {
+    /** Whether execution was successful */
+    success: boolean;
+    /** Agent that executed */
+    agentName: string;
+    /** Execution time in ms */
+    executionTime: number;
+    /** Whether fallback was used */
+    fallbackUsed: boolean;
+    /** Original agent if fallback was used */
+    originalAgent?: string;
+    /** Files modified */
+    filesModified: string[];
+    /** Violations detected */
+    violations: AgentViolation[];
+    /** Warnings generated */
+    warnings: AgentViolation[];
+    /** Error if failed */
+    error?: Error;
+}
+/**
+ * Agent violation (from quality gates)
+ */
+export interface AgentViolation {
+    type: string;
+    severity: ValidationSeverity;
+    message: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    agentName: string;
+    gateName?: string;
+}
+/**
+ * Routing rule for agent selection
+ */
+export interface AgentRoutingRule {
+    /** Pattern to match task description */
+    pattern: string | RegExp;
+    /** Agent to route to */
+    agent: string;
+    /** Priority (lower = higher priority) */
+    priority: number;
+    /** Condition function */
+    condition?: (task: TaskContext) => boolean;
+}
+/**
+ * Routing result from agent router
+ */
+export interface AgentRoutingResult {
+    /** Selected agent */
+    agent: Agent;
+    /** Matched rule */
+    matchedRule?: AgentRoutingRule;
+    /** Fallback agents if primary fails */
+    fallbacks: Agent[];
+    /** Confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Agent registry configuration
+ */
+export interface AgentRegistryConfig {
+    /** Enable auto-discovery of agents */
+    autoDiscover?: boolean;
+    /** Paths to search for project agents */
+    projectPaths?: string[];
+    /** Public tier configuration */
+    public?: {
+        enabled: boolean;
+        source?: string;
+    };
+    /** Private tier configuration */
+    private?: {
+        enabled: boolean;
+        source?: string;
+    };
+    /** Project tier configuration */
+    project?: {
+        enabled: boolean;
+        paths?: string[];
+    };
+}
+/**
+ * Agent loader configuration
+ */
+export interface AgentLoaderConfig {
+    /** Search paths for agents */
+    searchPaths: string[];
+    /** Enable auto-discovery */
+    autoDiscover: boolean;
+    /** Failure mode */
+    failureMode: 'throw' | 'warn' | 'silent';
+    /** Timeout for agent operations (ms) */
+    timeout: number;
+}
+/**
+ * Agent router configuration
+ */
+export interface AgentRouterConfig {
+    /** Default agent to use if no match */
+    defaultAgent: string;
+    /** Routing rules */
+    routingRules: AgentRoutingRule[];
+    /** Enable delegation between agents */
+    delegationEnabled: boolean;
+    /** Maximum delegation depth */
+    maxDelegationDepth?: number;
+}
+//# sourceMappingURL=types.d.ts.map