@dcyfr/ai 1.0.1 → 1.0.3

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

@@ -0,0 +1,345 @@
+/**
+ * Agent Registry - Multi-tier agent management
+ *
+ * Manages agents across three tiers with priority resolution:
+ * - project: Project-specific agents (highest priority)
+ * - private: @dcyfr/agents package (medium priority)
+ * - public: @dcyfr/ai built-in agents (lowest priority)
+ *
+ * @module @dcyfr/ai/agents/agent-registry
+ * @example
+ * ```typescript
+ * import { AgentRegistry } from '@dcyfr/ai/agents/agent-registry';
+ * import { dcyfrAgents } from '@dcyfr/agents';
+ *
+ * const registry = new AgentRegistry();
+ *
+ * // Register tier-specific sources
+ * registry.registerTier('public', '@dcyfr/ai/agents-builtin');
+ * registry.registerTier('private', dcyfrAgents);
+ * registry.registerTier('project', '.claude/agents');
+ *
+ * // Resolve agent with tier precedence
+ * const agent = registry.resolveAgent('test-engineer');
+ * ```
+ */
+import { AgentLoader, } from './agent-loader';
+/**
+ * Default registry configuration
+ */
+const DEFAULT_CONFIG = {
+    autoDiscover: false,
+    projectPaths: ['.claude/agents', '.github/agents'],
+    public: {
+        enabled: true,
+        source: '@dcyfr/ai/agents-builtin',
+    },
+    private: {
+        enabled: false,
+    },
+    project: {
+        enabled: true,
+        paths: ['.claude/agents', '.github/agents'],
+    },
+};
+/**
+ * Agent Registry - multi-tier agent management
+ */
+export class AgentRegistry {
+    tiers = new Map();
+    config;
+    initialized = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize the registry with configured tiers
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        // Initialize public tier if enabled
+        if (this.config.public?.enabled && this.config.public.source) {
+            await this.registerTier('public', this.config.public.source);
+        }
+        // Initialize private tier if enabled
+        if (this.config.private?.enabled && this.config.private.source) {
+            await this.registerTier('private', this.config.private.source);
+        }
+        // Initialize project tier if enabled
+        if (this.config.project?.enabled && this.config.project.paths) {
+            for (const path of this.config.project.paths) {
+                await this.registerTier('project', path);
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Register a tier with a source (package path or agent array)
+     */
+    async registerTier(tier, source) {
+        const loader = new AgentLoader({
+            searchPaths: typeof source === 'string' ? [source] : [],
+            autoDiscover: typeof source === 'string',
+            failureMode: 'warn',
+            timeout: 30000,
+        });
+        const tierSource = {
+            tier,
+            source,
+            loader,
+            loaded: false,
+        };
+        this.tiers.set(tier, tierSource);
+        // Load agents from source
+        await this.loadTier(tier);
+    }
+    /**
+     * Load agents for a specific tier
+     */
+    async loadTier(tier) {
+        const tierSource = this.tiers.get(tier);
+        if (!tierSource) {
+            throw new Error(`Tier '${tier}' is not registered`);
+        }
+        if (tierSource.loaded)
+            return;
+        const { source, loader } = tierSource;
+        if (typeof source === 'string') {
+            // Load from package or file path
+            try {
+                if (source.startsWith('@') || source.startsWith('.')) {
+                    // Try to import as a module that exports agents
+                    const module = await import(source);
+                    const agents = module.default || module.agents || module;
+                    if (Array.isArray(agents)) {
+                        await loader.loadAgents(agents, tier);
+                    }
+                    else if (typeof agents === 'object') {
+                        // Object with agent exports
+                        for (const [, agent] of Object.entries(agents)) {
+                            if (this.isAgent(agent)) {
+                                await loader.loadAgent(agent, tier);
+                            }
+                        }
+                    }
+                }
+                else {
+                    // Discover agents in path
+                    await loader.discoverAgents();
+                }
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to load tier '${tier}' from ${source}:`, error);
+            }
+        }
+        else {
+            // Load from agent array
+            await loader.loadAgents(source, tier);
+        }
+        tierSource.loaded = true;
+    }
+    /**
+     * Resolve an agent by name with tier precedence
+     * Priority: project > private > public
+     */
+    resolveAgent(name) {
+        const tierOrder = ['project', 'private', 'public'];
+        for (const tier of tierOrder) {
+            const tierSource = this.tiers.get(tier);
+            if (!tierSource)
+                continue;
+            const loaded = tierSource.loader.getAgent(name);
+            if (loaded && loaded.enabled) {
+                return loaded.agent;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get a loaded agent with metadata
+     */
+    getLoadedAgent(name) {
+        const tierOrder = ['project', 'private', 'public'];
+        for (const tier of tierOrder) {
+            const tierSource = this.tiers.get(tier);
+            if (!tierSource)
+                continue;
+            const loaded = tierSource.loader.getAgent(name);
+            if (loaded && loaded.enabled) {
+                return loaded;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all agents across all tiers
+     */
+    getAllAgents() {
+        const allAgents = new Map();
+        const tierOrder = ['public', 'private', 'project'];
+        // Load in reverse order so higher priority overwrites
+        for (const tier of tierOrder) {
+            const tierSource = this.tiers.get(tier);
+            if (!tierSource)
+                continue;
+            for (const agent of tierSource.loader.getAgents()) {
+                allAgents.set(agent.name, agent);
+            }
+        }
+        return Array.from(allAgents.values());
+    }
+    /**
+     * Get all agent manifests (for discovery/catalog)
+     */
+    getAllManifests() {
+        return this.getAllAgents().map((a) => a.manifest);
+    }
+    /**
+     * Get agents by category
+     */
+    getAgentsByCategory(category) {
+        return this.getAllAgents().filter((a) => a.manifest.category === category);
+    }
+    /**
+     * Get agents by tier
+     */
+    getAgentsByTier(tier) {
+        const tierSource = this.tiers.get(tier);
+        if (!tierSource)
+            return [];
+        return tierSource.loader.getAgents();
+    }
+    /**
+     * Get agents by tag
+     */
+    getAgentsByTag(tag) {
+        return this.getAllAgents().filter((a) => a.manifest.tags?.includes(tag));
+    }
+    /**
+     * Search agents by name or description
+     */
+    searchAgents(query) {
+        const lowerQuery = query.toLowerCase();
+        return this.getAllAgents().filter((a) => a.manifest.name.toLowerCase().includes(lowerQuery) ||
+            a.manifest.description.toLowerCase().includes(lowerQuery) ||
+            a.manifest.tags?.some((t) => t.toLowerCase().includes(lowerQuery)));
+    }
+    /**
+     * Merge agent configurations (overlay pattern)
+     * Base agent from lower tier, overrides from higher tier
+     */
+    mergeAgentConfigs(baseAgent, overrides) {
+        return {
+            ...baseAgent,
+            manifest: {
+                ...baseAgent.manifest,
+                ...(overrides.manifest || {}),
+            },
+            instructions: overrides.instructions || baseAgent.instructions,
+            systemPrompt: overrides.systemPrompt || baseAgent.systemPrompt,
+            onLoad: overrides.onLoad || baseAgent.onLoad,
+            onUnload: overrides.onUnload || baseAgent.onUnload,
+            onBeforeExecute: overrides.onBeforeExecute || baseAgent.onBeforeExecute,
+            onAfterExecute: overrides.onAfterExecute || baseAgent.onAfterExecute,
+            onError: overrides.onError || baseAgent.onError,
+        };
+    }
+    /**
+     * Enable an agent by name (searches all tiers)
+     */
+    enableAgent(name) {
+        for (const tierSource of this.tiers.values()) {
+            const agent = tierSource.loader.getAgent(name);
+            if (agent) {
+                tierSource.loader.enableAgent(name);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Disable an agent by name (searches all tiers)
+     */
+    disableAgent(name) {
+        for (const tierSource of this.tiers.values()) {
+            const agent = tierSource.loader.getAgent(name);
+            if (agent) {
+                tierSource.loader.disableAgent(name);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        const allAgents = this.getAllAgents();
+        const byTier = {
+            public: 0,
+            private: 0,
+            project: 0,
+        };
+        const byCategory = {};
+        let enabled = 0;
+        let disabled = 0;
+        for (const agent of allAgents) {
+            byTier[agent.tier]++;
+            const category = agent.manifest.category;
+            byCategory[category] = (byCategory[category] || 0) + 1;
+            if (agent.enabled) {
+                enabled++;
+            }
+            else {
+                disabled++;
+            }
+        }
+        return {
+            totalAgents: allAgents.length,
+            byTier,
+            byCategory,
+            enabled,
+            disabled,
+        };
+    }
+    /**
+     * Clear all tiers and agents
+     */
+    async clearAll() {
+        for (const tierSource of this.tiers.values()) {
+            await tierSource.loader.clearAll();
+        }
+        this.tiers.clear();
+        this.initialized = false;
+    }
+    /**
+     * Check if value is an Agent
+     */
+    isAgent(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            'manifest' in value &&
+            typeof value.manifest === 'object');
+    }
+}
+/**
+ * Global agent registry instance
+ */
+let globalRegistry = null;
+/**
+ * Get or create global agent registry
+ */
+export function getGlobalAgentRegistry(config) {
+    if (!globalRegistry) {
+        globalRegistry = new AgentRegistry(config);
+    }
+    return globalRegistry;
+}
+/**
+ * Reset global agent registry
+ */
+export function resetGlobalAgentRegistry() {
+    globalRegistry = null;
+}
+//# sourceMappingURL=agent-registry.js.map

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

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

package/dist/ai/agents/agent-router.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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}`);
+ * ```
+ */
+import type { Agent, AgentRouterConfig, AgentRoutingRule, AgentRoutingResult, AgentExecutionContext, AgentExecutionResult } from './types';
+import type { TaskContext } from '../types';
+import { AgentRegistry } from './agent-registry';
+/**
+ * Agent Router - routes tasks to appropriate agents
+ */
+export declare class AgentRouter {
+    private registry;
+    private config;
+    private delegationDepth;
+    constructor(registry: AgentRegistry, config?: Partial<AgentRouterConfig>);
+    /**
+     * Route a task to the most appropriate agent
+     */
+    route(task: TaskContext): Promise<AgentRoutingResult>;
+    /**
+     * Route with custom rules (merges with default rules)
+     */
+    routeWithRules(task: TaskContext, customRules: AgentRoutingRule[]): Promise<AgentRoutingResult>;
+    /**
+     * Delegate task to another agent
+     */
+    delegate(fromAgent: Agent, toAgentName: string, task: TaskContext): Promise<Agent>;
+    /**
+     * Execute task with automatic fallback
+     */
+    executeWithFallback(context: AgentExecutionContext, primaryAgent: Agent, fallbacks: Agent[]): Promise<AgentExecutionResult>;
+    /**
+     * Add a routing rule
+     */
+    addRule(rule: AgentRoutingRule): void;
+    /**
+     * Remove a routing rule by pattern
+     */
+    removeRule(pattern: string | RegExp): boolean;
+    /**
+     * Get all routing rules
+     */
+    getRules(): AgentRoutingRule[];
+    /**
+     * Reset delegation depth
+     */
+    resetDelegation(): void;
+    /**
+     * Get current delegation depth
+     */
+    getDelegationDepth(): number;
+    /**
+     * Find matching routing rules for a task
+     */
+    private findMatchingRules;
+    /**
+     * Find fallback agents for a primary agent
+     */
+    private findFallbacks;
+    /**
+     * Calculate confidence score for a routing match
+     */
+    private calculateConfidence;
+}
+/**
+ * Get or create global agent router
+ */
+export declare function getGlobalAgentRouter(registry: AgentRegistry, config?: Partial<AgentRouterConfig>): AgentRouter;
+/**
+ * Reset global agent router
+ */
+export declare function resetGlobalAgentRouter(): void;
+//# sourceMappingURL=agent-router.d.ts.map

package/dist/ai/agents/agent-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-router.d.ts","sourceRoot":"","sources":["../../../packages/ai/agents/agent-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA0FjD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,eAAe,CAAa;gBAGlC,QAAQ,EAAE,aAAa,EACvB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAMzC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiC3D;;OAEG;IACG,cAAc,CAClB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,gBAAgB,EAAE,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAW9B;;OAEG;IACG,QAAQ,CACZ,SAAS,EAAE,KAAK,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,KAAK,CAAC;IAiCjB;;OAEG;IACG,mBAAmB,CACvB,OAAO,EAAE,qBAAqB,EAC9B,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,KAAK,EAAE,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAgEhC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAMrC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAY7C;;OAEG;IACH,QAAQ,IAAI,gBAAgB,EAAE;IAI9B;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAa5B;AAOD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,WAAW,CAKb;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}