@deimoscloud/coreai 0.1.9 → 0.1.11

package/src/agents/compiler.ts

@@ -1,424 +0,0 @@
-/**
- * Agent Compiler
- *
- * Transforms YAML agent definitions into Claude-compatible Markdown files.
- */
-
-import { existsSync, mkdirSync, writeFileSync } from 'fs';
-import { join, dirname } from 'path';
-import type { CoreAIConfig } from '../config/types.js';
-import type { AgentDefinition, AgentMetadata, AgentSource } from './types.js';
-import { DEFAULT_AGENT_TOOLS } from './types.js';
-import { loadAgentsFromDirectory } from './loader.js';
-import { resolveAgentDefinition } from './resolver.js';
-
-/**
- * Options for compiling agents
- */
-export interface CompileOptions {
-  /**
-   * Output directory for compiled markdown files.
-   * Default: .claude/agents
-   */
-  outputDir?: string;
-
-  /**
-   * Core agents directory (built-in agents).
-   * Default: uses package's agents/ directory
-   */
-  coreAgentsDir?: string;
-
-  /**
-   * Custom agents directory (project-specific agents).
-   * Default: coreai/agents in project root
-   */
-  customAgentsDir?: string;
-
-  /**
-   * Project root directory.
-   * Default: process.cwd()
-   */
-  projectRoot?: string;
-
-  /**
-   * Filter function to select which agents to compile.
-   * Returns true to include the agent, false to exclude.
-   */
-  filter?: (agent: AgentDefinition) => boolean;
-
-  /**
-   * MCP server names to include as tools.
-   * These will be added to the agent's tools as mcp__<server-name>.
-   * Example: ['github', 'postgres'] -> 'mcp__github, mcp__postgres'
-   */
-  mcpServers?: string[];
-}
-
-/**
- * Result of compiling agents
- */
-export interface CompileResult {
-  /**
-   * Successfully compiled agents
-   */
-  compiled: {
-    role: string;
-    source: AgentSource;
-    outputPath: string;
-  }[];
-
-  /**
-   * Agents that failed to compile
-   */
-  errors: {
-    role: string;
-    source: AgentSource;
-    error: string;
-  }[];
-}
-
-/**
- * Build the tools string for agent frontmatter
- *
- * @param agent - Agent definition (may have custom tools)
- * @param mcpServers - Optional MCP server names to include
- * @returns Comma-separated list of tools
- */
-export function buildAgentTools(agent: AgentDefinition, mcpServers?: string[]): string {
-  // Start with agent-specific tools or defaults
-  const tools: string[] = agent.tools
-    ? [...agent.tools]
-    : [...DEFAULT_AGENT_TOOLS];
-
-  // Add MCP tools if servers are specified
-  if (mcpServers && mcpServers.length > 0) {
-    for (const server of mcpServers) {
-      tools.push(`mcp__${server}`);
-    }
-  }
-
-  return tools.join(', ');
-}
-
-/**
- * Generate markdown content from a resolved agent definition
- *
- * The output includes YAML frontmatter required by Claude Code for subagent detection.
- * See: https://code.claude.com/docs/en/sub-agents
- *
- * @param agent - Resolved agent definition
- * @param mcpServers - Optional MCP server names to include as tools
- */
-export function generateAgentMarkdown(agent: AgentDefinition, mcpServers?: string[]): string {
-  const lines: string[] = [];
-
-  // Build tools string
-  const tools = buildAgentTools(agent, mcpServers);
-
-  // YAML frontmatter (required by Claude Code for subagent detection)
-  lines.push('---');
-  lines.push(`name: ${agent.role}`);
-  // Flatten description to single line for YAML frontmatter
-  lines.push(`description: ${agent.description.replace(/\n/g, ' ').trim()}`);
-  lines.push(`tools: ${tools}`);
-  lines.push('---');
-  lines.push('');
-
-  // Header
-  lines.push(`# ${agent.display_name}`);
-  lines.push('');
-  lines.push(`**Role:** ${agent.role}`);
-  lines.push(`**Type:** ${agent.type}`);
-  lines.push('');
-
-  // Description
-  lines.push('## Description');
-  lines.push('');
-  lines.push(agent.description.trim());
-  lines.push('');
-
-  // Responsibilities
-  if (agent.responsibilities && agent.responsibilities.length > 0) {
-    lines.push('## Responsibilities');
-    lines.push('');
-    for (const responsibility of agent.responsibilities) {
-      lines.push(`- ${responsibility}`);
-    }
-    lines.push('');
-  }
-
-  // Expertise
-  if (agent.expertise) {
-    lines.push('## Expertise');
-    lines.push('');
-
-    if (agent.expertise.primary && agent.expertise.primary.length > 0) {
-      lines.push('### Primary Areas');
-      lines.push('');
-      for (const area of agent.expertise.primary) {
-        lines.push(`- ${area}`);
-      }
-      lines.push('');
-    }
-
-    if (agent.expertise.tech_stack) {
-      lines.push('### Tech Stack');
-      lines.push('');
-      const techStack = agent.expertise.tech_stack;
-      if (typeof techStack === 'string') {
-        lines.push(techStack);
-      } else if (typeof techStack === 'object') {
-        lines.push('```json');
-        lines.push(JSON.stringify(techStack, null, 2));
-        lines.push('```');
-      }
-      lines.push('');
-    }
-  }
-
-  // Skills
-  if (agent.skills && agent.skills.length > 0) {
-    lines.push('## Skills');
-    lines.push('');
-    for (const skill of agent.skills) {
-      lines.push(`- ${skill}`);
-    }
-    lines.push('');
-  }
-
-  // Principles
-  if (agent.principles) {
-    lines.push('## Principles');
-    lines.push('');
-
-    for (const [category, items] of Object.entries(agent.principles)) {
-      if (items && Array.isArray(items) && items.length > 0) {
-        const title = formatTitle(category);
-        lines.push(`### ${title}`);
-        lines.push('');
-        for (const item of items) {
-          lines.push(`- ${item}`);
-        }
-        lines.push('');
-      }
-    }
-  }
-
-  // Behaviors
-  if (agent.behaviors) {
-    lines.push('## Behaviors');
-    lines.push('');
-
-    if (agent.behaviors.workflow) {
-      lines.push(`**Workflow:** ${agent.behaviors.workflow}`);
-      lines.push('');
-    }
-
-    if (agent.behaviors.quality_gates) {
-      lines.push('### Quality Gates');
-      lines.push('');
-      const gates = agent.behaviors.quality_gates;
-      if (typeof gates === 'string') {
-        lines.push(gates);
-      } else if (typeof gates === 'object') {
-        lines.push('```json');
-        lines.push(JSON.stringify(gates, null, 2));
-        lines.push('```');
-      }
-      lines.push('');
-    }
-  }
-
-  // Context Sources
-  if (agent.context_sources) {
-    lines.push('## Context Sources');
-    lines.push('');
-
-    if (agent.context_sources.shared && agent.context_sources.shared.length > 0) {
-      lines.push('### Shared');
-      lines.push('');
-      for (const source of agent.context_sources.shared) {
-        lines.push(`- ${source}`);
-      }
-      lines.push('');
-    }
-
-    if (agent.context_sources.personal && agent.context_sources.personal.length > 0) {
-      lines.push('### Personal');
-      lines.push('');
-      for (const source of agent.context_sources.personal) {
-        lines.push(`- ${source}`);
-      }
-      lines.push('');
-    }
-  }
-
-  // Communication
-  if (agent.communication) {
-    lines.push('## Communication');
-    lines.push('');
-    if (agent.communication.inbox) {
-      lines.push(`**Inbox:** ${agent.communication.inbox}`);
-    }
-    if (agent.communication.outbox) {
-      lines.push(`**Outbox:** ${agent.communication.outbox}`);
-    }
-    lines.push('');
-  }
-
-  // Footer
-  lines.push('---');
-  lines.push('');
-  lines.push('*Generated by CoreAI*');
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-/**
- * Format a snake_case or kebab-case string as a title
- */
-function formatTitle(str: string): string {
-  return str.replace(/[_-]/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
-}
-
-/**
- * Compile a single agent to markdown
- *
- * @param agent - Agent definition to compile
- * @param config - Optional CoreAI config for variable resolution
- * @param mcpServers - Optional MCP server names to include as tools
- */
-export function compileAgent(
-  agent: AgentDefinition,
-  config?: CoreAIConfig,
-  mcpServers?: string[]
-): string {
-  const resolved = resolveAgentDefinition(agent, config);
-  return generateAgentMarkdown(resolved, mcpServers);
-}
-
-/**
- * Load all agents from core and custom directories
- */
-export function loadAllAgents(options: CompileOptions = {}): Map<string, AgentMetadata> {
-  const agents = new Map<string, AgentMetadata>();
-
-  // Load core agents
-  if (options.coreAgentsDir && existsSync(options.coreAgentsDir)) {
-    const coreAgents = loadAgentsFromDirectory(options.coreAgentsDir, 'core');
-    for (const [role, metadata] of coreAgents) {
-      agents.set(role, metadata);
-    }
-  }
-
-  // Load custom agents (can override core agents)
-  if (options.customAgentsDir && existsSync(options.customAgentsDir)) {
-    const customAgents = loadAgentsFromDirectory(options.customAgentsDir, 'custom');
-    for (const [role, metadata] of customAgents) {
-      // Check if this is overriding a core agent
-      if (agents.has(role)) {
-        metadata.source = 'override';
-      }
-      agents.set(role, metadata);
-    }
-  }
-
-  return agents;
-}
-
-/**
- * Filter agents based on team configuration.
- * Custom and override agents are always included regardless of team filter.
- */
-export function filterAgentsByTeam(
-  agents: Map<string, AgentMetadata>,
-  config?: CoreAIConfig
-): Map<string, AgentMetadata> {
-  if (!config?.team?.agents || config.team.agents.length === 0) {
-    // No team filter, return all agents
-    return agents;
-  }
-
-  const filtered = new Map<string, AgentMetadata>();
-
-  for (const [role, metadata] of agents) {
-    // Always include custom and override agents
-    if (metadata.source === 'custom' || metadata.source === 'override') {
-      filtered.set(role, metadata);
-    }
-    // Include core agents only if they're in the team list
-    else if (config.team.agents.includes(role)) {
-      filtered.set(role, metadata);
-    }
-  }
-
-  return filtered;
-}
-
-/**
- * Compile all agents and write to output directory
- */
-export function compileAgents(config?: CoreAIConfig, options: CompileOptions = {}): CompileResult {
-  const projectRoot = options.projectRoot ?? process.cwd();
-  const outputDir = options.outputDir ?? join(projectRoot, '.claude', 'agents');
-  const coreAgentsDir = options.coreAgentsDir ?? getCoreAgentsDir();
-  const customAgentsDir = options.customAgentsDir ?? join(projectRoot, 'coreai', 'agents');
-
-  const result: CompileResult = {
-    compiled: [],
-    errors: [],
-  };
-
-  // Load all agents
-  const allAgents = loadAllAgents({
-    ...options,
-    coreAgentsDir,
-    customAgentsDir,
-  });
-
-  // Filter by team if configured
-  const agents = filterAgentsByTeam(allAgents, config);
-
-  // Ensure output directory exists
-  if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
-  }
-
-  // Compile each agent
-  for (const [role, metadata] of agents) {
-    // Apply custom filter if provided
-    if (options.filter && !options.filter(metadata.definition)) {
-      continue;
-    }
-
-    try {
-      const markdown = compileAgent(metadata.definition, config, options.mcpServers);
-      const outputPath = join(outputDir, `${role}.md`);
-
-      writeFileSync(outputPath, markdown, 'utf-8');
-
-      result.compiled.push({
-        role,
-        source: metadata.source,
-        outputPath,
-      });
-    } catch (error) {
-      result.errors.push({
-        role,
-        source: metadata.source,
-        error: error instanceof Error ? error.message : String(error),
-      });
-    }
-  }
-
-  return result;
-}
-
-/**
- * Get the default core agents directory
- */
-export function getCoreAgentsDir(): string {
-  // Navigate from dist/agents/compiler.js to agents/
-  return join(dirname(dirname(dirname(import.meta.url.replace('file://', '')))), 'agents');
-}

package/src/agents/index.ts

@@ -1,37 +0,0 @@
-/**
- * Agents Module
- *
- * Provides agent loading, validation, and management for CoreAI.
- */
-
-export * from './types.js';
-export {
-  loadAgentFromFile,
-  loadAgentsFromDirectory,
-  parseAgentYaml,
-  validateAgentDefinition,
-  getRoleFromFilename,
-  AgentError,
-  type AgentErrorCode,
-} from './loader.js';
-export {
-  resolveString,
-  resolveObject,
-  resolveAgentDefinition,
-  hasVariables,
-  extractVariables,
-  ResolutionError,
-  type ResolutionContext,
-  type ResolutionOptions,
-} from './resolver.js';
-export {
-  buildAgentTools,
-  generateAgentMarkdown,
-  compileAgent,
-  compileAgents,
-  loadAllAgents,
-  filterAgentsByTeam,
-  getCoreAgentsDir,
-  type CompileOptions,
-  type CompileResult,
-} from './compiler.js';