osagent-core 0.1.12

package/dist/src/orchestration/orchestrator.js

@@ -0,0 +1,436 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AgentRegistry, defaultAgentRegistry } from './agent-registry.js';
+import { OrchestrationQueue } from './orchestration-queue.js';
+import { SkillDetector } from './skill-detector.js';
+import { defaultContextManager } from './context-manager.js';
+/**
+ * Default orchestration configuration
+ */
+const DEFAULT_CONFIG = {
+    autoDispatchThreshold: 0.75,
+    maxParallelAgents: 3,
+    maxQueueSize: 100,
+    enableSkillDetection: true,
+    enableAutoDispatch: true,
+    enableDynamicAgents: true,
+    enableDynamicSkills: true,
+    enableContextHierarchy: true,
+    defaultModel: 'sonnet',
+};
+/**
+ * Main Orchestrator - coordinates agent selection and task execution
+ */
+export class Orchestrator {
+    config;
+    registry;
+    queue;
+    skillDetector;
+    eventListeners = new Map();
+    executor = null;
+    isProcessing = false;
+    constructor(config = {}, registry) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.registry = registry ?? defaultAgentRegistry;
+        this.queue = new OrchestrationQueue(this.config.maxQueueSize);
+        this.skillDetector = new SkillDetector(this.registry, this.config.autoDispatchThreshold);
+        // Subscribe to queue events
+        this.queue.on('enqueue', (prompt) => {
+            this.emit('prompt_received', prompt.id, { prompt: prompt.originalPrompt });
+        });
+    }
+    /**
+     * Set the agent executor function
+     */
+    setExecutor(executor) {
+        this.executor = executor;
+    }
+    /**
+     * Submit a prompt for orchestration
+     */
+    async submit(prompt, options = {}) {
+        // Enqueue the prompt
+        const queuedPrompt = this.queue.enqueue(prompt, {
+            priority: options.priority,
+            parentPromptId: options.parentPromptId,
+        });
+        // Detect skills if enabled
+        let detectionResult;
+        if (this.config.enableSkillDetection && !options.skipDetection) {
+            this.emit('skill_detection_start', queuedPrompt.id);
+            detectionResult = this.skillDetector.detect(prompt);
+            this.queue.updateStatus(queuedPrompt.id, 'analyzing', { detectionResult });
+            this.emit('skill_detection_complete', queuedPrompt.id, {
+                skills: detectionResult.detectedSkills,
+                confidence: detectionResult.confidence,
+            });
+        }
+        // Make orchestration decision
+        const decision = this.makeDecision(prompt, detectionResult);
+        // Select agent
+        const selectedAgent = decision.agents[0] ?? null;
+        if (selectedAgent) {
+            this.queue.updateStatus(queuedPrompt.id, 'queued', { assignedAgent: selectedAgent });
+            this.emit('agent_selected', queuedPrompt.id, {
+                agent: selectedAgent.displayName,
+                tier: selectedAgent.tier,
+            });
+        }
+        // Auto-dispatch if conditions are met
+        if (this.config.enableAutoDispatch &&
+            detectionResult?.shouldAutoDispatch &&
+            selectedAgent &&
+            this.executor) {
+            return this.executePrompt(queuedPrompt, decision, selectedAgent);
+        }
+        // Return decision for manual handling
+        return {
+            promptId: queuedPrompt.id,
+            decision,
+            shouldDelegate: selectedAgent !== null,
+            delegatedAgentId: selectedAgent?.id,
+            success: true,
+        };
+    }
+    /**
+     * Execute a queued prompt with the assigned agent
+     */
+    async executePrompt(queuedPrompt, decision, agent) {
+        if (!this.executor) {
+            return {
+                promptId: queuedPrompt.id,
+                decision,
+                shouldDelegate: false,
+                success: false,
+                error: 'No executor configured',
+            };
+        }
+        const startTime = Date.now();
+        this.queue.updateStatus(queuedPrompt.id, 'delegated', { assignedAgent: agent });
+        this.emit('delegation_start', queuedPrompt.id, { agent: agent.displayName });
+        try {
+            const result = await this.executor(agent, queuedPrompt.originalPrompt, {
+                decision,
+                detectionResult: queuedPrompt.detectionResult,
+            });
+            const duration = Date.now() - startTime;
+            if (result.success) {
+                this.queue.updateStatus(queuedPrompt.id, 'completed', { result: result.result });
+                this.registry.updateAgentStats(agent.id, true, duration);
+                this.emit('delegation_complete', queuedPrompt.id, {
+                    success: true,
+                    duration,
+                });
+                return {
+                    promptId: queuedPrompt.id,
+                    decision,
+                    shouldDelegate: true,
+                    delegatedAgentId: agent.id,
+                    result: result.result,
+                    duration,
+                    success: true,
+                };
+            }
+            else {
+                this.queue.updateStatus(queuedPrompt.id, 'failed', { error: result.error });
+                this.registry.updateAgentStats(agent.id, false, duration);
+                this.emit('orchestration_error', queuedPrompt.id, { error: result.error });
+                return {
+                    promptId: queuedPrompt.id,
+                    decision,
+                    shouldDelegate: true,
+                    delegatedAgentId: agent.id,
+                    success: false,
+                    error: result.error,
+                    duration,
+                };
+            }
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.queue.updateStatus(queuedPrompt.id, 'failed', { error: errorMessage });
+            this.registry.updateAgentStats(agent.id, false, duration);
+            this.emit('orchestration_error', queuedPrompt.id, { error: errorMessage });
+            return {
+                promptId: queuedPrompt.id,
+                decision,
+                shouldDelegate: true,
+                delegatedAgentId: agent.id,
+                success: false,
+                error: errorMessage,
+                duration,
+            };
+        }
+    }
+    /**
+     * Make orchestration decision based on prompt analysis
+     */
+    makeDecision(prompt, detectionResult) {
+        const agents = [];
+        let mode = 'direct';
+        let complexity = 'simple';
+        if (detectionResult) {
+            // Determine complexity from detection
+            const skills = detectionResult.detectedSkills;
+            if (skills.length > 2 || detectionResult.confidence < 0.5) {
+                complexity = 'complex';
+            }
+            else if (skills.length > 1) {
+                complexity = 'moderate';
+            }
+            // Select agents based on detection
+            if (detectionResult.primaryAgent) {
+                agents.push(detectionResult.primaryAgent);
+                mode = 'single_agent';
+            }
+            if (complexity === 'complex' && detectionResult.secondaryAgents.length > 0) {
+                agents.push(...detectionResult.secondaryAgents);
+                mode = skills.some(s => s.skillName === 'orchestration') ? 'parallel' : 'sequential';
+            }
+        }
+        // Fallback: use keyword matching if no detection
+        if (agents.length === 0) {
+            const matches = this.registry.findAgentsForPrompt(prompt);
+            if (matches.length > 0) {
+                agents.push(matches[0].agent);
+                mode = 'single_agent';
+            }
+        }
+        const reasoning = this.generateDecisionReasoning(mode, agents, complexity, detectionResult);
+        // Get context from detection result or create default
+        const context = detectionResult?.activeContext ?? defaultContextManager.getCurrentContext();
+        return {
+            mode,
+            agents,
+            reasoning,
+            estimatedComplexity: complexity,
+            context,
+        };
+    }
+    /**
+     * Generate human-readable reasoning for the decision
+     */
+    generateDecisionReasoning(mode, agents, complexity, detectionResult) {
+        const parts = [];
+        parts.push(`Complexity: ${complexity}`);
+        if (detectionResult) {
+            const topSkills = detectionResult.detectedSkills.slice(0, 3).map(s => s.skillName);
+            if (topSkills.length > 0) {
+                parts.push(`Detected skills: ${topSkills.join(', ')}`);
+            }
+            parts.push(`Confidence: ${(detectionResult.confidence * 100).toFixed(0)}%`);
+        }
+        if (agents.length > 0) {
+            const agentNames = agents.map(a => `${a.displayName} (${a.tier})`);
+            parts.push(`Mode: ${mode}`);
+            parts.push(`Agents: ${agentNames.join(', ')}`);
+        }
+        else {
+            parts.push('Using default handling - no specialist agent matched');
+        }
+        return parts.join('. ');
+    }
+    /**
+     * Process the next item in the queue
+     */
+    async processNext() {
+        if (this.isProcessing)
+            return null;
+        const prompt = this.queue.dequeue();
+        if (!prompt)
+            return null;
+        this.isProcessing = true;
+        try {
+            const decision = this.makeDecision(prompt.originalPrompt, prompt.detectionResult);
+            const agent = decision.agents[0];
+            if (agent && this.executor) {
+                return await this.executePrompt(prompt, decision, agent);
+            }
+            return {
+                promptId: prompt.id,
+                decision,
+                shouldDelegate: false,
+                success: true,
+            };
+        }
+        finally {
+            this.isProcessing = false;
+        }
+    }
+    /**
+     * Run verification checks on completed task
+     */
+    async verify(promptId, checks) {
+        const prompt = this.queue.get(promptId);
+        if (!prompt || prompt.status !== 'completed') {
+            return {
+                passed: false,
+                checks: [],
+                overallConfidence: 0,
+            };
+        }
+        const checkResults = [];
+        let passedCount = 0;
+        for (const check of checks) {
+            // Simple verification - in a real implementation this would run actual checks
+            const passed = true; // Placeholder
+            checkResults.push({
+                name: check,
+                passed,
+                output: passed ? 'Check passed' : 'Check failed',
+            });
+            if (passed)
+                passedCount++;
+        }
+        const overallConfidence = checks.length > 0 ? passedCount / checks.length : 1;
+        return {
+            passed: overallConfidence >= 0.8,
+            checks: checkResults,
+            overallConfidence,
+        };
+    }
+    /**
+     * Create response metadata for a completed prompt
+     */
+    createResponseMetadata(promptId, verification) {
+        const prompt = this.queue.get(promptId);
+        if (!prompt)
+            return null;
+        const agent = prompt.assignedAgent;
+        const detection = prompt.detectionResult;
+        return {
+            agentId: agent?.id ?? 'default',
+            agentName: agent?.displayName ?? 'Default Agent',
+            agentTier: agent?.tier ?? 'utility',
+            mode: detection ? 'single_agent' : 'direct',
+            taskType: detection?.detectedSkills[0]?.skillName ?? 'general',
+            memoryAction: 'none',
+            verification,
+            duration: prompt.completedAt && prompt.startedAt
+                ? prompt.completedAt - prompt.startedAt
+                : 0,
+        };
+    }
+    /**
+     * Get queue statistics
+     */
+    getStats() {
+        return this.queue.getStats();
+    }
+    /**
+     * Get prompt by ID
+     */
+    getPrompt(id) {
+        return this.queue.get(id);
+    }
+    /**
+     * Get all queued prompts
+     */
+    getQueuedPrompts() {
+        return this.queue.getQueued();
+    }
+    /**
+     * Get recent history
+     */
+    getHistory(limit = 50) {
+        return this.queue.getHistory(limit);
+    }
+    /**
+     * Cancel a queued prompt
+     */
+    cancel(promptId) {
+        return this.queue.cancel(promptId);
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        if (config.autoDispatchThreshold !== undefined) {
+            this.skillDetector.setAutoDispatchThreshold(config.autoDispatchThreshold);
+        }
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get agent registry
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Subscribe to orchestration events
+     */
+    on(eventType, callback) {
+        if (!this.eventListeners.has(eventType)) {
+            this.eventListeners.set(eventType, []);
+        }
+        this.eventListeners.get(eventType).push(callback);
+        return () => {
+            const callbacks = this.eventListeners.get(eventType);
+            if (callbacks) {
+                const index = callbacks.indexOf(callback);
+                if (index > -1) {
+                    callbacks.splice(index, 1);
+                }
+            }
+        };
+    }
+    /**
+     * Emit an orchestration event
+     */
+    emit(type, promptId, data) {
+        const event = {
+            type,
+            promptId,
+            timestamp: Date.now(),
+            data,
+        };
+        const callbacks = this.eventListeners.get(type);
+        if (callbacks) {
+            for (const callback of callbacks) {
+                try {
+                    callback(event);
+                }
+                catch (e) {
+                    console.error(`Error in orchestration event listener for ${type}:`, e);
+                }
+            }
+        }
+    }
+    /**
+     * Export state for persistence
+     */
+    export() {
+        return {
+            config: this.config,
+            queue: this.queue.export(),
+            agents: this.registry.export(),
+        };
+    }
+    /**
+     * Import state
+     */
+    import(state) {
+        if (state.config) {
+            this.updateConfig(state.config);
+        }
+        if (state.queue) {
+            this.queue.import(state.queue);
+        }
+        if (state.agents) {
+            this.registry.import(state.agents);
+        }
+    }
+}
+// Default singleton instance
+export const defaultOrchestrator = new Orchestrator();
+//# sourceMappingURL=orchestrator.js.map

package/dist/src/orchestration/orchestrator.js.map

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

package/dist/src/orchestration/response-formatter.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ResponseMetadata, VerificationResult, VerificationCheck, RegisteredAgent, OrchestrationMode, ActiveContext, MemoryAction } from './types.js';
+/**
+ * Formats responses with agent metadata, verification, and context
+ */
+export declare class ResponseFormatter {
+    /**
+     * Create response metadata
+     */
+    createMetadata(options: {
+        agent: RegisteredAgent;
+        mode: OrchestrationMode;
+        taskType: string;
+        memoryAction?: MemoryAction;
+        verification?: VerificationResult;
+        duration: number;
+        tokensUsed?: number;
+        skillUsed?: string;
+        context?: ActiveContext;
+    }): ResponseMetadata;
+    /**
+     * Format response header
+     */
+    formatHeader(metadata: ResponseMetadata): string;
+    /**
+     * Format verification section
+     */
+    formatVerification(verification: VerificationResult): string;
+    /**
+     * Format context section
+     */
+    formatContext(context: ActiveContext): string;
+    /**
+     * Format complete response with all sections
+     */
+    formatCompleteResponse(content: string, metadata: ResponseMetadata, verification?: VerificationResult): string;
+    /**
+     * Format compact response (for inline display)
+     */
+    formatCompactResponse(metadata: ResponseMetadata): string;
+    /**
+     * Format duration
+     */
+    formatDuration(ms: number): string;
+    /**
+     * Get agent icon for tier
+     */
+    private getAgentIcon;
+    /**
+     * Get mode label
+     */
+    private getModeLabel;
+    /**
+     * Get memory action label
+     */
+    private getMemoryLabel;
+}
+/**
+ * Runs verification checks
+ */
+export declare class VerificationRunner {
+    private shellExecutor?;
+    /**
+     * Set shell executor
+     */
+    setShellExecutor(executor: (command: string) => Promise<{
+        stdout: string;
+        exitCode: number;
+    }>): void;
+    /**
+     * Run a verification check
+     */
+    runCheck(check: {
+        name: string;
+        type: 'command' | 'file_exists' | 'pattern_match' | 'test_pass' | 'custom';
+        command?: string;
+        pattern?: string;
+        files?: string[];
+        customCheck?: string;
+    }): Promise<VerificationCheck>;
+    /**
+     * Run command check
+     */
+    private runCommandCheck;
+    /**
+     * Run test check
+     */
+    private runTestCheck;
+    /**
+     * Run file exists check
+     */
+    private runFileExistsCheck;
+    /**
+     * Run pattern match check
+     */
+    private runPatternMatchCheck;
+    /**
+     * Run all verification checks
+     */
+    runAll(checks: Array<{
+        name: string;
+        type: 'command' | 'file_exists' | 'pattern_match' | 'test_pass' | 'custom';
+        command?: string;
+        pattern?: string;
+        files?: string[];
+        customCheck?: string;
+    }>): Promise<VerificationResult>;
+    /**
+     * Run standard verification (build, test, lint)
+     */
+    runStandardVerification(): Promise<VerificationResult>;
+}
+export declare const defaultResponseFormatter: ResponseFormatter;
+export declare const defaultVerificationRunner: VerificationRunner;