erosolar-cli 1.7.14 → 1.7.15

package/dist/bin/core/agentRulebook.js

@@ -1,135 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
-const DEFAULT_RULEBOOK_ROOT = resolve(MODULE_DIR, '..', '..');
-const manifestCache = new Map();
-const promptCache = new Map();
-export function loadAgentRulebook(profile, options = {}) {
-    // If inline manifest is provided, use it directly
-    if (options.inline) {
-        const manifest = options.inline;
-        if (manifest.profile !== profile) {
-            throw new Error(`Rulebook profile mismatch for ${profile}. Expected \"${profile}\" but inline manifest declares \"${manifest.profile}\".`);
-        }
-        return manifest;
-    }
-    // Otherwise load from file
-    const root = options.root ?? DEFAULT_RULEBOOK_ROOT;
-    const filePath = resolveRulebookPath(profile, root, options.file);
-    const cacheKey = filePath;
-    const cached = manifestCache.get(cacheKey);
-    if (cached) {
-        return cached;
-    }
-    const raw = readFileSync(filePath, 'utf8');
-    const manifest = JSON.parse(raw);
-    if (manifest.profile !== profile) {
-        throw new Error(`Rulebook profile mismatch for ${profile}. Expected \"${profile}\" but file declares \"${manifest.profile}\".`);
-    }
-    manifestCache.set(cacheKey, manifest);
-    return manifest;
-}
-export function buildAgentRulebookPrompt(profile, options = {}) {
-    // If inline, don't cache (since it might change)
-    if (options.inline) {
-        const manifest = loadAgentRulebook(profile, { inline: options.inline });
-        return formatAgentRulebook(manifest);
-    }
-    const root = options.root ?? DEFAULT_RULEBOOK_ROOT;
-    const filePath = resolveRulebookPath(profile, root, options.file);
-    const cacheKey = filePath;
-    const cached = promptCache.get(cacheKey);
-    if (cached) {
-        return cached;
-    }
-    const manifest = loadAgentRulebook(profile, { root, file: options.file });
-    const prompt = formatAgentRulebook(manifest);
-    promptCache.set(cacheKey, prompt);
-    return prompt;
-}
-export function formatAgentRulebook(manifest) {
-    const lines = [];
-    const headerLabel = manifest.label || manifest.profile;
-    lines.push(`${headerLabel} — rulebook version ${manifest.version} (contract ${manifest.contractVersion}).`);
-    if (manifest.description) {
-        lines.push(manifest.description.trim());
-    }
-    if (manifest.globalPrinciples?.length) {
-        lines.push('\nGLOBAL PRINCIPLES:');
-        for (const rule of manifest.globalPrinciples) {
-            lines.push(formatRuleLine(rule));
-        }
-    }
-    for (const phase of manifest.phases) {
-        const phaseSummary = [phase.label || phase.id];
-        if (phase.description) {
-            phaseSummary.push(`– ${phase.description}`);
-        }
-        lines.push(`\nPHASE ${phase.id}: ${phaseSummary.join(' ')}`);
-        if (phase.trigger) {
-            lines.push(`  Trigger: ${phase.trigger}`);
-        }
-        for (const step of phase.steps) {
-            lines.push(formatStepLine(step));
-        }
-    }
-    return lines.filter(Boolean).join('\n');
-}
-function resolveRulebookPath(profile, root, fileOverride) {
-    const trimmedOverride = fileOverride?.trim();
-    if (trimmedOverride) {
-        return resolve(root, trimmedOverride);
-    }
-    return resolve(root, 'agents', `${profile}.rules.json`);
-}
-function formatRuleLine(rule, indent = '  ') {
-    const severity = rule.severity?.toUpperCase() ?? 'INFO';
-    const parts = [`[${severity}] (${rule.id}) ${rule.summary}`];
-    if (rule.detail) {
-        parts.push(`— ${rule.detail}`);
-    }
-    if (rule.evidenceRequired) {
-        parts.push(`Evidence: ${rule.evidenceRequired}`);
-    }
-    return `${indent}${parts.join(' ')}`;
-}
-function formatStepLine(step) {
-    const details = [];
-    if (step.intent) {
-        details.push(step.intent);
-    }
-    if (step.description && step.description !== step.intent) {
-        details.push(step.description);
-    }
-    const header = [`  STEP ${step.id}: ${step.title}`];
-    if (details.length) {
-        header.push(`(${details.join(' — ')})`);
-    }
-    const lines = [header.join(' ')];
-    if (step.entryCriteria?.length) {
-        lines.push(`    Entry: ${step.entryCriteria.join('; ')}`);
-    }
-    if (step.exitCriteria?.length) {
-        lines.push(`    Exit: ${step.exitCriteria.join('; ')}`);
-    }
-    if (step.allowedTools?.length) {
-        lines.push(`    Allowed tools: ${step.allowedTools.join(', ')}`);
-    }
-    if (step.blockedTools?.length) {
-        lines.push(`    Blocked tools: ${step.blockedTools.join(', ')}`);
-    }
-    if (step.notes?.length) {
-        lines.push(`    Notes: ${step.notes.join(' ')}`);
-    }
-    for (const rule of step.rules) {
-        lines.push(formatRuleLine(rule, '    - '));
-    }
-    if (step.subSteps?.length) {
-        lines.push('    Sub-steps:');
-        for (const subStep of step.subSteps) {
-            lines.push(formatStepLine(subStep).replace(/^  /gm, '      '));
-        }
-    }
-    return lines.join('\n');
-}

package/dist/bin/core/agentSchemaLoader.js

@@ -1,233 +0,0 @@
-/**
- * Centralized agent schema loader.
- *
- * This module provides type-safe loading and validation of the centralized
- * agent configuration schema from src/contracts/agent-schemas.json.
- * All agent-related configuration should be loaded through this module
- * to ensure consistency across the application.
- */
-import { readFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-/**
- * Cached schema instance
- */
-let cachedSchema = null;
-/**
- * Load the centralized agent schemas manifest.
- * Results are cached for performance.
- *
- * @returns The complete agent schemas manifest
- * @throws Error if the schema file cannot be read or parsed
- */
-export function getAgentSchemas() {
-    if (cachedSchema) {
-        return cachedSchema;
-    }
-    try {
-        const schemaPath = join(__dirname, '..', 'contracts', 'agent-schemas.json');
-        const raw = readFileSync(schemaPath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        // Basic validation
-        validateAgentSchemas(parsed);
-        cachedSchema = parsed;
-        return cachedSchema;
-    }
-    catch (error) {
-        throw new Error(`Failed to load agent schemas: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * Get all provider configurations
- */
-export function getProviders() {
-    const schemas = getAgentSchemas();
-    return schemas.providers;
-}
-/**
- * Get a specific provider by ID
- */
-export function getProvider(providerId) {
-    const providers = getProviders();
-    return providers.find((p) => p.id === providerId);
-}
-/**
- * Get all model configurations (includes both static and discovered models)
- */
-export function getModels() {
-    const schemas = getAgentSchemas();
-    const staticModels = schemas.models;
-    // Try to load discovered models
-    try {
-        const { getCachedDiscoveredModels } = require('./modelDiscovery.js');
-        const discoveredModels = getCachedDiscoveredModels();
-        // Merge models, preferring static definitions over discovered ones
-        const staticIds = new Set(staticModels.map((m) => m.id));
-        const uniqueDiscovered = discoveredModels.filter((m) => !staticIds.has(m.id));
-        return [...staticModels, ...uniqueDiscovered];
-    }
-    catch (error) {
-        // If discovery module fails, just return static models
-        return staticModels;
-    }
-}
-/**
- * Get models for a specific provider
- */
-export function getModelsByProvider(providerId) {
-    const models = getModels();
-    return models.filter((m) => m.provider === providerId);
-}
-/**
- * Get a specific model by ID
- */
-export function getModel(modelId) {
-    const models = getModels();
-    return models.find((m) => m.id === modelId);
-}
-/**
- * Get all agent profiles
- */
-export function getProfiles() {
-    const schemas = getAgentSchemas();
-    return schemas.profiles;
-}
-/**
- * Get a specific profile by name
- */
-export function getProfile(profileName) {
-    const profiles = getProfiles();
-    return profiles.find((p) => p.name === profileName);
-}
-/**
- * Get all slash commands
- */
-export function getSlashCommands() {
-    const schemas = getAgentSchemas();
-    return schemas.slashCommands ?? [];
-}
-/**
- * Get all capabilities
- */
-export function getCapabilities() {
-    const schemas = getAgentSchemas();
-    return schemas.capabilities ?? [];
-}
-/**
- * Validate the agent schemas manifest structure
- */
-function validateAgentSchemas(manifest) {
-    // Check required fields
-    if (!manifest.contractVersion) {
-        throw new Error('Missing required field: contractVersion');
-    }
-    if (!manifest.version) {
-        throw new Error('Missing required field: version');
-    }
-    if (!Array.isArray(manifest.providers) || manifest.providers.length === 0) {
-        throw new Error('Missing or empty required field: providers');
-    }
-    if (!Array.isArray(manifest.models) || manifest.models.length === 0) {
-        throw new Error('Missing or empty required field: models');
-    }
-    if (!Array.isArray(manifest.profiles) || manifest.profiles.length === 0) {
-        throw new Error('Missing or empty required field: profiles');
-    }
-    // Validate provider uniqueness
-    const providerIds = new Set();
-    for (const provider of manifest.providers) {
-        if (!provider.id || !provider.label) {
-            throw new Error('Provider missing required fields: id, label');
-        }
-        if (providerIds.has(provider.id)) {
-            throw new Error(`Duplicate provider ID: ${provider.id}`);
-        }
-        providerIds.add(provider.id);
-    }
-    // Validate model uniqueness and provider references
-    const modelIds = new Set();
-    for (const model of manifest.models) {
-        if (!model.id || !model.label || !model.provider) {
-            throw new Error('Model missing required fields: id, label, provider');
-        }
-        if (modelIds.has(model.id)) {
-            throw new Error(`Duplicate model ID: ${model.id}`);
-        }
-        if (!providerIds.has(model.provider)) {
-            throw new Error(`Model "${model.id}" references unknown provider: ${model.provider}`);
-        }
-        modelIds.add(model.id);
-    }
-    // Validate profile uniqueness and references
-    const profileNames = new Set();
-    for (const profile of manifest.profiles) {
-        if (!profile.name || !profile.label || !profile.defaultProvider || !profile.defaultModel) {
-            throw new Error('Profile missing required fields: name, label, defaultProvider, defaultModel');
-        }
-        if (profileNames.has(profile.name)) {
-            throw new Error(`Duplicate profile name: ${profile.name}`);
-        }
-        if (!providerIds.has(profile.defaultProvider)) {
-            throw new Error(`Profile "${profile.name}" references unknown provider: ${profile.defaultProvider}`);
-        }
-        if (!modelIds.has(profile.defaultModel)) {
-            throw new Error(`Profile "${profile.name}" references unknown model: ${profile.defaultModel}`);
-        }
-        profileNames.add(profile.name);
-    }
-    // Validate slash commands uniqueness
-    if (manifest.slashCommands) {
-        const commands = new Set();
-        for (const cmd of manifest.slashCommands) {
-            if (!cmd.command || !cmd.description) {
-                throw new Error('Slash command missing required fields: command, description');
-            }
-            if (commands.has(cmd.command)) {
-                throw new Error(`Duplicate slash command: ${cmd.command}`);
-            }
-            commands.add(cmd.command);
-        }
-    }
-    // Validate capabilities uniqueness
-    if (manifest.capabilities) {
-        const capabilities = new Set();
-        for (const cap of manifest.capabilities) {
-            if (!cap.id || !cap.label) {
-                throw new Error('Capability missing required fields: id, label');
-            }
-            if (capabilities.has(cap.id)) {
-                throw new Error(`Duplicate capability ID: ${cap.id}`);
-            }
-            capabilities.add(cap.id);
-        }
-    }
-}
-/**
- * Clear the cached schema (useful for testing)
- */
-export function clearSchemaCache() {
-    cachedSchema = null;
-}
-/**
- * Validate that a provider ID exists in the schema
- */
-export function isValidProvider(providerId) {
-    const provider = getProvider(providerId);
-    return provider !== undefined;
-}
-/**
- * Validate that a model ID exists in the schema
- */
-export function isValidModel(modelId) {
-    const model = getModel(modelId);
-    return model !== undefined;
-}
-/**
- * Validate that a profile name exists in the schema
- */
-export function isValidProfile(profileName) {
-    const profile = getProfile(profileName);
-    return profile !== undefined;
-}