erosolar-cli 1.7.195 → 1.7.196

package/dist/core/agentSchemaLoader.js

@@ -0,0 +1,234 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=agentSchemaLoader.js.map

package/dist/core/agentSchemaLoader.js.map

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

package/dist/core/cliTestHarness.d.ts

@@ -0,0 +1,200 @@
+/**
+ * CLI Test Harness - PTY-based interactive CLI testing
+ *
+ * This module provides real runtime verification of CLI behavior by:
+ * 1. Spawning the CLI in a pseudo-terminal (PTY)
+ * 2. Sending simulated user input (including paste sequences)
+ * 3. Capturing and analyzing output
+ * 4. Verifying expected behaviors
+ *
+ * @license MIT
+ */
+import { EventEmitter } from 'node:events';
+export interface CLITestConfig {
+    /** Working directory for the CLI */
+    cwd: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Timeout for the entire test (ms) */
+    timeout?: number;
+    /** Whether to use PTY mode (requires node-pty) */
+    usePty?: boolean;
+    /** Path to CLI entry point */
+    cliPath?: string;
+}
+export interface TestInput {
+    /** Type of input to send */
+    type: 'text' | 'paste' | 'key' | 'wait';
+    /** The content to send */
+    content?: string;
+    /** For 'key' type: special key name */
+    key?: 'enter' | 'tab' | 'escape' | 'ctrl-c' | 'ctrl-d';
+    /** For 'wait' type: milliseconds to wait */
+    delay?: number;
+}
+export interface TestExpectation {
+    /** Type of expectation */
+    type: 'output_contains' | 'output_matches' | 'output_not_contains' | 'exit_code';
+    /** Pattern or value to check */
+    value: string | number | RegExp;
+    /** Description for error messages */
+    description?: string;
+    /** Timeout for this specific expectation (ms) */
+    timeout?: number;
+}
+export interface CLITestScenario {
+    /** Unique test identifier */
+    id: string;
+    /** Human-readable description */
+    description: string;
+    /** Category of test */
+    category: 'paste' | 'input' | 'command' | 'output' | 'behavior';
+    /** Sequence of inputs to send */
+    inputs: TestInput[];
+    /** Expected outcomes */
+    expectations: TestExpectation[];
+    /** Setup commands to run before test */
+    setup?: string[];
+    /** Cleanup commands to run after test */
+    cleanup?: string[];
+}
+export interface TestResult {
+    scenario: CLITestScenario;
+    passed: boolean;
+    duration: number;
+    output: string;
+    errors: string[];
+    expectations: Array<{
+        expectation: TestExpectation;
+        passed: boolean;
+        actual?: string;
+        reason?: string;
+    }>;
+}
+declare const SPECIAL_KEYS: Record<string, string>;
+export declare class CLITestHarness extends EventEmitter {
+    private config;
+    private process;
+    private output;
+    private errors;
+    private exitCode;
+    private ptyModule;
+    constructor(config: CLITestConfig);
+    /**
+     * Try to load node-pty for true PTY support
+     */
+    private loadPtyModule;
+    /**
+     * Start the CLI process
+     */
+    start(): Promise<void>;
+    /**
+     * Start CLI with PTY (for interactive features like bracketed paste)
+     */
+    private startWithPty;
+    /**
+     * Start CLI with standard stdio (fallback, limited interactive support)
+     */
+    private startWithStdio;
+    /**
+     * Send input to the CLI
+     */
+    write(input: string): void;
+    /**
+     * Send a bracketed paste sequence
+     */
+    paste(content: string): void;
+    /**
+     * Send a special key
+     */
+    sendKey(key: keyof typeof SPECIAL_KEYS): void;
+    /**
+     * Wait for output matching a pattern
+     */
+    waitForOutput(pattern: string | RegExp, timeout?: number): Promise<string>;
+    /**
+     * Wait for a specified duration
+     */
+    wait(ms: number): Promise<void>;
+    /**
+     * Get current output
+     */
+    getOutput(): string;
+    /**
+     * Get current errors
+     */
+    getErrors(): string;
+    /**
+     * Stop the CLI process
+     */
+    stop(): Promise<number>;
+    /**
+     * Run a complete test scenario
+     */
+    runScenario(scenario: CLITestScenario): Promise<TestResult>;
+    /**
+     * Execute a single input action
+     */
+    private executeInput;
+    /**
+     * Check a single expectation
+     */
+    private checkExpectation;
+}
+/**
+ * Create a paste handling test scenario
+ */
+export declare function createPasteTestScenario(content: string, expectedLineCount: number): CLITestScenario;
+/**
+ * Create a multi-line input test scenario
+ */
+export declare function createMultiLineInputScenario(): CLITestScenario;
+/**
+ * Create a slash command test scenario
+ */
+export declare function createSlashCommandScenario(command: string): CLITestScenario;
+/**
+ * Run verification tests for a specific claim type
+ */
+export declare function runVerificationTests(claimType: string, workingDir: string): Promise<{
+    passed: boolean;
+    results: TestResult[];
+    summary: string;
+}>;
+/**
+ * Claim structure for unified verification
+ */
+export interface VerificationClaim {
+    id: string;
+    statement: string;
+    category: string;
+    context: Record<string, unknown>;
+}
+/**
+ * Result of verifying a single claim
+ */
+export interface UnifiedClaimResult {
+    claim: VerificationClaim;
+    passed: boolean;
+    method: 'pty' | 'shell' | 'file_check' | 'unit_test';
+    output: string;
+    error?: string;
+    duration: number;
+}
+/**
+ * Verify a single claim using the appropriate method (PTY-based)
+ */
+export declare function verifyClaim(claim: VerificationClaim, workingDir: string): Promise<UnifiedClaimResult>;
+/**
+ * Verify all claims using unified PTY harness
+ */
+export declare function verifyAllClaims(claims: VerificationClaim[], workingDir: string): Promise<{
+    results: UnifiedClaimResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+    };
+}>;
+export default CLITestHarness;
+//# sourceMappingURL=cliTestHarness.d.ts.map

package/dist/core/cliTestHarness.d.ts.map

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