synapsexcoder 6.0.0

package/dist/agents/agent-config-manager.js

@@ -0,0 +1,313 @@
+/**
+ * Agent Configuration Manager - Markdown-based Agent Definitions
+ *
+ * Inspired by OpenAgentsControl's editable agents via markdown files.
+ * Allows defining and configuring agents through structured markdown.
+ */
+import { readFileSync, existsSync, readdirSync, unlinkSync, writeFileSync, mkdirSync, } from "fs";
+import { join } from "path";
+import { v4 as uuidv4 } from "uuid";
+export class AgentConfigManager {
+    agentsDir;
+    agentDefinitions = new Map();
+    constructor(projectRoot) {
+        this.agentsDir = join(projectRoot, "agents");
+        // Ensure agents directory exists
+        if (!existsSync(this.agentsDir)) {
+            // We'll create it when saving agents
+        }
+        this.loadAgentDefinitions();
+    }
+    // ========================================================================
+    // Agent Definition Loading
+    // ========================================================================
+    loadAgentDefinitions() {
+        if (!existsSync(this.agentsDir))
+            return;
+        const files = readdirSync(this.agentsDir).filter((f) => f.endsWith(".md"));
+        for (const file of files) {
+            try {
+                const filePath = join(this.agentsDir, file);
+                const content = readFileSync(filePath, "utf-8");
+                const definition = this.parseAgentDefinition(content, file);
+                if (definition) {
+                    this.agentDefinitions.set(definition.id, definition);
+                }
+            }
+            catch (error) {
+                console.warn(`Failed to load agent definition from ${file}:`, error);
+            }
+        }
+    }
+    parseAgentDefinition(content, filename) {
+        const lines = content.split("\n");
+        if (lines.length < 3)
+            return null;
+        // Parse frontmatter
+        let frontmatter = {};
+        let contentStart = 0;
+        if (lines[0].trim() === "---") {
+            let frontmatterEnd = -1;
+            for (let i = 1; i < lines.length; i++) {
+                if (lines[i].trim() === "---") {
+                    frontmatterEnd = i;
+                    break;
+                }
+                const line = lines[i].trim();
+                if (line.includes(":")) {
+                    const [key, ...valueParts] = line.split(":");
+                    const value = valueParts.join(":").trim();
+                    try {
+                        frontmatter[key.trim()] = JSON.parse(value);
+                    }
+                    catch {
+                        frontmatter[key.trim()] = value;
+                    }
+                }
+            }
+            contentStart = frontmatterEnd + 1;
+        }
+        // Parse content sections
+        const bodyContent = lines.slice(contentStart).join("\n");
+        const sections = this.parseSections(bodyContent);
+        // Build definition
+        const id = frontmatter.id || uuidv4();
+        const type = frontmatter.type;
+        if (!type)
+            return null;
+        return {
+            id,
+            name: frontmatter.name || filename.replace(".md", ""),
+            type,
+            description: frontmatter.description || "",
+            config: {
+                type,
+                mode: frontmatter.mode || "subagent",
+                model: frontmatter.model,
+                temperature: frontmatter.temperature,
+                maxSteps: frontmatter.maxSteps,
+                description: frontmatter.description,
+                color: frontmatter.color,
+                tools: frontmatter.tools,
+                hidden: frontmatter.hidden,
+                timeout: frontmatter.timeout,
+            },
+            prompts: {
+                system: sections.system,
+                task: sections.task,
+                examples: this.parseExamples(sections.examples),
+            },
+            tools: frontmatter.tools || [],
+            behaviors: {
+                approvalRequired: frontmatter.approvalRequired,
+                contextAware: frontmatter.contextAware !== false,
+                learningEnabled: frontmatter.learningEnabled !== false,
+                maxIterations: frontmatter.maxIterations,
+                temperature: frontmatter.temperature,
+            },
+            metadata: {
+                author: frontmatter.author,
+                version: frontmatter.version,
+                tags: frontmatter.tags,
+                created: frontmatter.created,
+                updated: frontmatter.updated,
+            },
+        };
+    }
+    parseSections(content) {
+        const sections = {};
+        const lines = content.split("\n");
+        let currentSection = "";
+        let currentContent = [];
+        for (const line of lines) {
+            const headerMatch = line.match(/^##\s+(.+)$/);
+            if (headerMatch) {
+                if (currentSection) {
+                    sections[currentSection.toLowerCase()] = currentContent
+                        .join("\n")
+                        .trim();
+                }
+                currentSection = headerMatch[1];
+                currentContent = [];
+            }
+            else {
+                currentContent.push(line);
+            }
+        }
+        if (currentSection) {
+            sections[currentSection.toLowerCase()] = currentContent.join("\n").trim();
+        }
+        return sections;
+    }
+    parseExamples(examplesText) {
+        if (!examplesText)
+            return [];
+        const examples = [];
+        const blocks = examplesText.split(/###?\s+/);
+        for (const block of blocks) {
+            if (!block.trim())
+                continue;
+            const lines = block.split("\n");
+            let input = "";
+            let output = "";
+            let explanation = "";
+            let currentSection = "";
+            for (const line of lines) {
+                if (line.toLowerCase().includes("input:")) {
+                    currentSection = "input";
+                    input = line.substring(line.indexOf(":") + 1).trim();
+                }
+                else if (line.toLowerCase().includes("output:")) {
+                    currentSection = "output";
+                    output = line.substring(line.indexOf(":") + 1).trim();
+                }
+                else if (line.toLowerCase().includes("explanation:")) {
+                    currentSection = "explanation";
+                    explanation = line.substring(line.indexOf(":") + 1).trim();
+                }
+                else if (currentSection) {
+                    if (currentSection === "input")
+                        input += "\n" + line;
+                    else if (currentSection === "output")
+                        output += "\n" + line;
+                    else if (currentSection === "explanation")
+                        explanation += "\n" + line;
+                }
+            }
+            if (input || output) {
+                examples.push({
+                    input: input.trim(),
+                    output: output.trim(),
+                    explanation: explanation.trim() || undefined,
+                });
+            }
+        }
+        return examples;
+    }
+    // ========================================================================
+    // Agent Definition Management
+    // ========================================================================
+    getAgentDefinition(id) {
+        return this.agentDefinitions.get(id);
+    }
+    getAllAgentDefinitions() {
+        return Array.from(this.agentDefinitions.values());
+    }
+    getAgentDefinitionsByType(type) {
+        return this.getAllAgentDefinitions().filter((def) => def.type === type);
+    }
+    createAgentDefinition(definition) {
+        const id = uuidv4();
+        const fullDefinition = { ...definition, id };
+        this.agentDefinitions.set(id, fullDefinition);
+        this.saveAgentDefinition(fullDefinition);
+        return id;
+    }
+    updateAgentDefinition(id, updates) {
+        const existing = this.agentDefinitions.get(id);
+        if (!existing)
+            return false;
+        const updated = { ...existing, ...updates, id };
+        this.agentDefinitions.set(id, updated);
+        this.saveAgentDefinition(updated);
+        return true;
+    }
+    deleteAgentDefinition(id) {
+        const definition = this.agentDefinitions.get(id);
+        if (!definition)
+            return false;
+        this.agentDefinitions.delete(id);
+        const markdownPath = join(this.agentsDir, `${id}.md`);
+        if (existsSync(markdownPath)) {
+            try {
+                unlinkSync(markdownPath);
+                console.info(`Deleted agent markdown file: ${markdownPath}`);
+            }
+            catch (error) {
+                console.warn(`Failed to delete markdown file ${markdownPath}:`, error);
+            }
+        }
+        return true;
+    }
+    // ========================================================================
+    // File Operations
+    // ========================================================================
+    saveAgentDefinition(definition) {
+        // Ensure agents directory exists
+        if (!existsSync(this.agentsDir)) {
+            try {
+                mkdirSync(this.agentsDir, { recursive: true });
+                console.info(`Created agents directory: ${this.agentsDir}`);
+            }
+            catch (error) {
+                console.warn(`Failed to create agents directory:`, error);
+                return;
+            }
+        }
+        // Serialize and write the file
+        const content = this.serializeAgentDefinition(definition);
+        const filePath = join(this.agentsDir, `${definition.id}.md`);
+        try {
+            writeFileSync(filePath, content, "utf-8");
+            console.info(`Saved agent definition to: ${filePath}`);
+        }
+        catch (error) {
+            console.warn(`Failed to write agent definition to ${filePath}:`, error);
+        }
+    }
+    serializeAgentDefinition(definition) {
+        const frontmatter = {
+            id: definition.id,
+            name: definition.name,
+            type: definition.type,
+            description: definition.description,
+            ...definition.config,
+            ...definition.behaviors,
+            ...definition.metadata,
+        };
+        let content = "---\n";
+        for (const [key, value] of Object.entries(frontmatter)) {
+            if (value !== undefined) {
+                content += `${key}: ${JSON.stringify(value)}\n`;
+            }
+        }
+        content += "---\n\n";
+        if (definition.prompts.system) {
+            content += `## System Prompt\n\n${definition.prompts.system}\n\n`;
+        }
+        if (definition.prompts.task) {
+            content += `## Task Prompt\n\n${definition.prompts.task}\n\n`;
+        }
+        if (definition.prompts.examples && definition.prompts.examples.length > 0) {
+            content += `## Examples\n\n`;
+            for (const example of definition.prompts.examples) {
+                content += `### Example\n\n`;
+                content += `**Input:** ${example.input}\n\n`;
+                content += `**Output:** ${example.output}\n\n`;
+                if (example.explanation) {
+                    content += `**Explanation:** ${example.explanation}\n\n`;
+                }
+            }
+        }
+        return content;
+    }
+    // ========================================================================
+    // Agent Instantiation
+    // ========================================================================
+    createAgentFromDefinition(definitionId, messageBus, toolBridge) {
+        const definition = this.getAgentDefinition(definitionId);
+        if (!definition) {
+            throw new Error(`Agent definition not found: ${definitionId}`);
+        }
+        // Import the createAgent function dynamically
+        const { createAgent } = require("./base-agents.js");
+        return createAgent(definition.type, messageBus, toolBridge, definition.config);
+    }
+}
+// ========================================================================
+// Factory Function
+// ========================================================================
+export function createAgentConfigManager(projectRoot) {
+    return new AgentConfigManager(projectRoot);
+}
+//# sourceMappingURL=agent-config-manager.js.map

package/dist/agents/agent-config-manager.js.map

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

package/dist/agents/base-agents.d.ts

@@ -0,0 +1,352 @@
+/**
+ * SynapseXcoder V6 - Base Agent Class
+ *
+ * All specialized agents (Planner, Analyzer, Reviewer, etc.) extend this base class.
+ * Provides common functionality: task execution, metrics tracking, subagent spawning,
+ * and communication with the OpenCode tool bridge.
+ */
+import { EventEmitter } from "events";
+import type { AgentType, AgentConfig, AgentStatus, Task, TaskResult, Artifact, ExecutionContext, GatekeeperReview, GatekeeperConfig, GatekeeperReport, RevisionHistory } from "../types/index.js";
+import { MessageBus } from "../messages/message-bus.js";
+import { OpenCodeToolBridge } from "../synapsexcoder/tool-bridge.js";
+import { ContextSystem } from "../context/context-system.js";
+import { ThoughtsManager } from "../thoughts/thoughts-manager.js";
+import { AgentConfigManager } from "./agent-config-manager.js";
+import { CommandProcessor } from "../commands/command-processor.js";
+import { TeamCollaborationSystem } from "../team/team-collaboration.js";
+import { PluginManager } from "../plugins/plugin-system.js";
+import { TokenOptimizer } from "../optimization/token-optimizer.js";
+/**
+ * Resolve model with fallback candidates
+ */
+export declare function resolveModelCandidates(userModel?: string): string[];
+/**
+ * Check if error is ProviderModelNotFoundError
+ */
+export declare function isProviderModelNotFoundError(error: string): boolean;
+export declare abstract class BaseAgent extends EventEmitter {
+    readonly id: string;
+    readonly type: AgentType;
+    config: AgentConfig;
+    protected memory: Map<string, unknown>;
+    protected status: AgentStatus;
+    protected messageBus: MessageBus;
+    protected toolBridge: OpenCodeToolBridge;
+    protected artifacts: Artifact[];
+    protected isRunning: boolean;
+    protected abortController: AbortController | null;
+    constructor(type: AgentType, config: Partial<AgentConfig>, messageBus: MessageBus, toolBridge: OpenCodeToolBridge);
+    private createInitialStatus;
+    abstract execute(task: Task): Promise<TaskResult>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    abort(reason: string): Promise<void>;
+    getStatus(): AgentStatus;
+    protected updateStatus(status: AgentStatus["status"], details?: string): void;
+    protected recordTaskCompletion(tokensUsed: number, toolsInvoked: number, executionTime: number): void;
+    protected recordTaskFailure(): void;
+    protected sendMessage(recipient: AgentType | "broadcast", type: string, payload: unknown): Promise<string>;
+    protected sendTaskResult(recipient: AgentType, result: TaskResult, correlationId?: string): Promise<string>;
+    protected sendTaskError(recipient: AgentType, taskId: string, error: string, correlationId?: string): Promise<string>;
+    protected sendStatusUpdate(status: string, details?: Record<string, unknown>): Promise<string>;
+    protected sendApprovalRequest(request: {
+        taskId: string;
+        changes: Array<{
+            file: string;
+            type: "edit" | "create" | "delete";
+            before?: string;
+            after: string;
+            reason: string;
+        }>;
+        riskLevel: "low" | "medium" | "high";
+        explanation: string;
+    }): Promise<string>;
+    protected requestApproval(taskId: string, changes: Array<{
+        file: string;
+        type: "edit" | "create" | "delete";
+        before?: string;
+        after: string;
+        reason: string;
+    }>, explanation: string, riskLevel?: "low" | "medium" | "high"): Promise<boolean>;
+    private waitForApproval;
+    protected readFile(path: string): Promise<string | null>;
+    protected readFiles(paths: string[]): Promise<Map<string, string | null>>;
+    protected writeFile(path: string, content: string): Promise<boolean>;
+    protected editFile(path: string, oldString: string, newString: string): Promise<boolean>;
+    protected listDir(path: string, recursive?: boolean): Promise<string | null>;
+    protected searchFiles(pattern: string, options?: {
+        path?: string;
+        include?: string;
+        exclude?: string;
+    }): Promise<string | null>;
+    protected runBash(command: string, options?: {
+        cwd?: string;
+        timeout?: number;
+    }): Promise<string | null>;
+    protected runGit(args: string[]): Promise<string | null>;
+    protected webSearch(query: string, numResults?: number): Promise<string | null>;
+    protected callModel(prompt: string, options?: {
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string | null>;
+    protected createArtifact(type: Artifact["type"], name: string, content: unknown): Artifact;
+    protected setMemory(key: string, value: unknown): void;
+    protected getMemory(key: string): unknown;
+    protected clearMemory(): void;
+    getArtifacts(): Artifact[];
+    clearArtifacts(): void;
+}
+export declare class MasterAgent extends BaseAgent {
+    private activeSubAgents;
+    private subAgentFactory;
+    private listenerStops;
+    private contextSystem;
+    private thoughtsManager;
+    private agentConfigManager;
+    private commandProcessor;
+    private teamSystem;
+    private pluginManager;
+    private tokenOptimizer;
+    private gatekeeperCoordinator;
+    private enableGatekeeper;
+    private gatekeeperReviewLevel;
+    private gatekeeperMaxRevisions;
+    private daspController;
+    private daspEnabled;
+    constructor(messageBus: MessageBus, toolBridge: OpenCodeToolBridge, config?: Partial<AgentConfig>, projectRoot?: string);
+    execute(task: Task): Promise<TaskResult>;
+    private buildPhases;
+    /**
+     * Check if a phase should be parallelized based on context
+     */
+    protected shouldParallelizePhase(phaseId: string, context: ExecutionContext): boolean;
+    /**
+     * Divide a large task into smaller batches for parallel execution
+     */
+    protected divideTaskIntoBatches(originalTask: Task, batchSize?: number): Task[];
+    /**
+     * Execute multiple subagents in parallel for a single phase
+     */
+    protected executePhaseInParallel(phase: {
+        id: string;
+        agentType: AgentType;
+        prompt: string;
+    }, rollingContext: ExecutionContext): Promise<TaskResult[]>;
+    /**
+     * Execute a single task with model fallback
+     */
+    private executeSingleTask;
+    /**
+     * Execute phases with gatekeeper review after each phase.
+     * Gatekeeper reviews each phase output before proceeding to the next.
+     * If gatekeeper requests revision, the affected phase is re-executed.
+     * If gatekeeper requests restart, the entire pipeline restarts.
+     */
+    private executePhasesWithGatekeeper;
+    /**
+     * Execute a single phase with gatekeeper review (extracted for reuse)
+     */
+    private executePhaseWithGatekeeper;
+    /**
+     * Perform gatekeeper review for a phase
+     */
+    private performGatekeeperReview;
+    /**
+     * Prepare a revised prompt based on gatekeeper feedback
+     */
+    private prepareRevisionPrompt;
+    /**
+     * Generate final gatekeeper report
+     */
+    private generateGatekeeperReport;
+    /**
+     * Execute a single phase (extracted from executePhases)
+     */
+    private executeSinglePhase;
+    /**
+     * Merge results from multiple parallel subagents into a single result
+     */
+    private mergeParallelResults;
+    private enhancePromptWithContext;
+    private extractKeywords;
+    /** Get a cached sub-agent or create a fresh one from the factory */
+    private getOrCreateSubAgent;
+    /** Collect artifacts from master and all registered sub-agents */
+    private collectAllArtifacts;
+    private synthesizeOutput;
+    registerSubAgent(agentId: string, agent: BaseAgent): void;
+    unregisterSubAgent(agentId: string): void;
+    getActiveSubAgents(): Map<string, BaseAgent>;
+    getContextSystem(): ContextSystem;
+    getThoughtsManager(): ThoughtsManager;
+    getAgentConfigManager(): AgentConfigManager;
+    getCommandProcessor(): CommandProcessor;
+    getTeamSystem(): TeamCollaborationSystem;
+    getPluginManager(): PluginManager;
+    getTokenOptimizer(): TokenOptimizer;
+    /**
+     * Enable or disable gatekeeper review
+     */
+    setGatekeeperEnabled(enabled: boolean): void;
+    /**
+     * Check if gatekeeper is enabled
+     */
+    isGatekeeperEnabled(): boolean;
+    /**
+     * Get the gatekeeper coordinator instance
+     */
+    getGatekeeperCoordinator(): GatekeeperCoordinator | null;
+    /**
+     * Configure gatekeeper review level
+     */
+    setGatekeeperReviewLevel(level: "quick" | "standard" | "thorough"): void;
+    /**
+     * Set maximum number of revision attempts per phase
+     */
+    setGatekeeperMaxRevisions(max: number): void;
+    /**
+     * Get current gatekeeper configuration
+     */
+    getGatekeeperConfig(): {
+        enabled: boolean;
+        reviewLevel: "quick" | "standard" | "thorough";
+        maxRevisions: number;
+        coordinatorStatus: Map<string, AgentStatus> | null;
+    };
+    processCommand(command: string): Promise<any>;
+    private storeExecutionKnowledge;
+}
+export declare abstract class SubAgent extends BaseAgent {
+    protected masterAgent: MasterAgent | null;
+    constructor(type: AgentType, config: Partial<AgentConfig>, messageBus: MessageBus, toolBridge: OpenCodeToolBridge);
+    setMasterAgent(master: MasterAgent): void;
+    /**
+     * Start the sub-agent's message loop.
+     * Listens for task_dispatch messages addressed to this agent type and processes them.
+     * Returns a stop function to cancel the loop.
+     */
+    startListening(): () => void;
+    execute(task: Task): Promise<TaskResult>;
+    protected abstract performTask(task: Task): Promise<unknown>;
+}
+export declare class PlannerAgent extends SubAgent {
+    protected performTask(task: Task): Promise<unknown>;
+    /**
+     * Local fallback: parse task description to build a real plan without a model.
+     */
+    private localPlanFallback;
+    /**
+     * Estimate complexity from task description text.
+     */
+    private estimateComplexityFromText;
+}
+export declare class AnalyzerAgent extends SubAgent {
+    protected performTask(task: Task): Promise<unknown>;
+    /**
+     * Local fallback: perform real static analysis on provided files without a model.
+     */
+    private localAnalysisFallback;
+    /**
+     * Compute basic file metrics for JSON parse fallback.
+     */
+    private computeFileMetrics;
+}
+export declare class ReviewerAgent extends SubAgent {
+    protected performTask(task: Task): Promise<unknown>;
+    /**
+     * Local fallback: review code quality based on analysis output and file content.
+     */
+    private localReviewFallback;
+}
+export declare class RewriterAgent extends SubAgent {
+    protected performTask(task: Task): Promise<unknown>;
+    /**
+     * Local fallback: apply basic code transformations without a model.
+     */
+    private localRewriteFallback;
+    /**
+     * Sort import statements alphabetically while preserving groups.
+     */
+    private sortImports;
+}
+export declare class UiDesignerAgent extends SubAgent {
+    protected performTask(task: Task): Promise<unknown>;
+    /**
+     * Local fallback: generate a real UI analysis and skeletal component.
+     */
+    private localUiDesignFallback;
+    /**
+     * Detect UI frameworks from file contents.
+     */
+    private detectFrameworks;
+    /**
+     * Detect accessibility issues in UI files.
+     */
+    private detectA11yIssues;
+    /**
+     * Infer component name from task prompt.
+     */
+    private inferComponentName;
+    private generateReactForm;
+    private generateHtmlForm;
+    private generateReactModal;
+    private generateHtmlModal;
+    private generateReactNav;
+    private generateReactList;
+    private generateReactComponent;
+}
+export declare class ResearcherAgent extends SubAgent {
+    protected performTask(task: Task): Promise<unknown>;
+    /**
+     * Local fallback: extract topics, search local files, and return findings.
+     */
+    private localResearchFallback;
+    /**
+     * Extract a relevant snippet from file content based on matched topics.
+     */
+    private extractRelevantSnippet;
+}
+export declare class GatekeeperAgent extends SubAgent {
+    private reviewConfig;
+    private revisionHistory;
+    constructor(messageBus: MessageBus, toolBridge: OpenCodeToolBridge, config?: Partial<AgentConfig> & {
+        reviewConfig?: Partial<GatekeeperConfig>;
+    });
+    private getDefaultCriteria;
+    protected performTask(task: Task): Promise<GatekeeperReview>;
+    private performComprehensiveReview;
+    private buildReviewPrompt;
+    private parseReviewResponse;
+    private analyzeResponseText;
+    private calculateDecision;
+    private calculateConfidence;
+    private getCriteriaCheckList;
+    private generateWarnings;
+    addRevision(iteration: number, phaseId: string, originalIssue: string, revision: string): void;
+    getRevisionHistory(): RevisionHistory[];
+    getConfig(): GatekeeperConfig;
+    updateConfig(config: Partial<GatekeeperConfig>): void;
+}
+export declare class GatekeeperCoordinator {
+    private gatekeepers;
+    private reviewQueue;
+    private isProcessing;
+    constructor(messageBus: MessageBus, toolBridge: OpenCodeToolBridge, maxConcurrentReviews?: number);
+    private getAvailableGatekeeper;
+    submitForReview(task: Task): Promise<GatekeeperReview>;
+    private performReview;
+    private processQueue;
+    reviewAllPhases(phaseOutputs: Array<{
+        phaseId: string;
+        agentType: AgentType;
+        output: unknown;
+        context: ExecutionContext;
+    }>): Promise<GatekeeperReport>;
+    private buildMasterDecision;
+    private generateSummary;
+    private generateNextSteps;
+    getGatekeeperStatuses(): Map<string, AgentStatus>;
+    shutdown(): Promise<void>;
+}
+export declare function createAgent(type: AgentType, messageBus: MessageBus, toolBridge: OpenCodeToolBridge, config?: Partial<AgentConfig>, projectRoot?: string): BaseAgent;
+//# sourceMappingURL=base-agents.d.ts.map