neuro-cli 4.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,439 @@
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+    name?: string;
+    timestamp?: number;
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolResult {
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+            enum?: string[];
+        }>;
+        required: string[];
+    };
+}
+export interface AgentConfig {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: string[];
+    autoApprove?: boolean;
+    maxIterations?: number;
+    /** Custom agent defined by user */
+    isCustom?: boolean;
+    /** Tags for categorizing agents */
+    tags?: string[];
+}
+export interface ModelConfig {
+    id: string;
+    name: string;
+    provider: string;
+    contextWindow: number;
+    maxOutput: number;
+    inputPrice: number;
+    outputPrice: number;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsStreaming: boolean;
+}
+export interface NeuroConfig {
+    apiKey: string;
+    baseUrl: string;
+    defaultModel: string;
+    agents: Record<string, AgentConfig>;
+    tools: {
+        autoApprove: string[];
+        requireApproval: string[];
+        denied: string[];
+    };
+    context: {
+        maxTokens: number;
+        systemPromptRatio: number;
+    };
+    session: {
+        autoSave: boolean;
+        maxHistory: number;
+    };
+    ui: {
+        theme: 'dark' | 'light' | 'dracula' | 'nord';
+        showTokenCount: boolean;
+        showCost: boolean;
+        streaming: boolean;
+        syntaxHighlight: boolean;
+    };
+    permissionMode: PermissionMode;
+    fallbackChain: FallbackModelChain;
+    doomLoop: DoomLoopConfig;
+    mcp: {
+        servers: Record<string, MCPServerConfig>;
+        autoConnect: boolean;
+    };
+    diffPreview: boolean;
+    /** Sandbox configuration */
+    sandbox: SandboxConfigType;
+    /** Spending limit in USD (0 = unlimited) */
+    spendingLimit: number;
+    /** Prompt cache configuration */
+    promptCache: PromptCacheConfig;
+    /** Custom agents defined by the user */
+    customAgents: Record<string, AgentConfig>;
+    /** Telemetry configuration */
+    telemetry: TelemetryConfigType;
+    /** Vim mode configuration */
+    vimMode: VimModeConfigType;
+    /** i18n / language configuration */
+    i18n: I18nConfigType;
+    /** Multimodal / image support configuration */
+    multimodal: MultimodalConfigType;
+    /** Voice I/O configuration */
+    voice: VoiceConfigType;
+    /** API server configuration */
+    apiServer: APIServerConfigType;
+    /** Cloud sync configuration */
+    cloudSync: CloudSyncConfigType;
+    /** Web dashboard configuration */
+    dashboard: DashboardConfigType;
+    /** v4.0: Auto mode configuration */
+    autoMode: AutoModeConfigType;
+    /** v4.0: Scheduled tasks configuration */
+    scheduledTasks: ScheduledTasksConfigType;
+    /** v4.0: Linting configuration */
+    linting: LintingConfigType;
+    /** v4.0: Testing configuration */
+    testing: TestingConfigType;
+    /** v4.0: Code review configuration */
+    codeReview: CodeReviewConfigType;
+    /** v4.0: Security scanner configuration */
+    securityScanner: SecurityScannerConfigType;
+}
+export interface Session {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    messages: Message[];
+    workingDirectory: string;
+    model: string;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCost: number;
+    agentHistory: AgentExecution[];
+    /** Session tags for categorization */
+    tags: string[];
+    /** Session description (auto-generated or user-set) */
+    description?: string;
+    /** Whether this is a fork of another session */
+    forkedFrom?: string;
+    /** Parent session ID */
+    parentSessionId?: string;
+}
+export interface AgentExecution {
+    agentName: string;
+    task: string;
+    startTime: number;
+    endTime?: number;
+    iterations: number;
+    tokensUsed: number;
+    status: 'running' | 'completed' | 'failed' | 'cancelled';
+    result?: string;
+}
+export interface ApprovalRequest {
+    toolName: string;
+    args: Record<string, unknown>;
+    risk: 'low' | 'medium' | 'high';
+    description: string;
+}
+export interface FileChange {
+    path: string;
+    type: 'create' | 'modify' | 'delete';
+    content?: string;
+    diff?: string;
+}
+export interface SearchResult {
+    file: string;
+    line: number;
+    column: number;
+    text: string;
+    match: string;
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    duration: number;
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cost: number;
+}
+export type PermissionMode = 'manual' | 'auto' | 'plan' | 'yolo';
+export interface FallbackModelChain {
+    models: string[];
+    maxRetries: number;
+    retryDelayMs: number;
+}
+export interface DoomLoopConfig {
+    maxConsecutiveErrors: number;
+    maxRepetitiveActions: number;
+    similarityThreshold: number;
+    autoBreak: boolean;
+}
+export interface HeadlessOptions {
+    prompt: string;
+    model?: string;
+    agent?: string;
+    maxTurns?: number;
+    allowedTools?: string[];
+    outputFormat?: 'text' | 'json' | 'stream-json';
+    autoApprove?: boolean;
+    continueSession?: string;
+}
+export interface MCPServerConfig {
+    transport: 'stdio' | 'sse' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    disabled?: boolean;
+    autoReconnect?: boolean;
+    maxReconnectAttempts?: number;
+    healthCheckIntervalMs?: number;
+}
+export interface SandboxConfigType {
+    enabled: boolean;
+    rootDir: string;
+    allowedDirs: string[];
+    deniedDirs: string[];
+    deniedPatterns: string[];
+    allowCommands: boolean;
+    allowedCommands: string[];
+    deniedCommands: string[];
+    backupOnModify: boolean;
+    backupDir: string;
+    maxFileSize: number;
+    allowNetwork: boolean;
+    allowEnvAccess: boolean;
+    readOnly: boolean;
+}
+export interface PromptCacheConfig {
+    enabled: boolean;
+    /** Cache directory */
+    cacheDir: string;
+    /** Maximum cache entries */
+    maxEntries: number;
+    /** TTL in milliseconds (default: 1 hour) */
+    ttlMs: number;
+    /** Similarity threshold for cache hits (0-1) */
+    similarityThreshold: number;
+}
+export interface SessionExport {
+    version: string;
+    exportedAt: number;
+    session: Session;
+    neuroVersion: string;
+}
+export interface TelemetryConfigType {
+    /** Whether telemetry is enabled (opt-in) */
+    enabled: boolean;
+    /** Whether to track model performance */
+    trackModelPerformance: boolean;
+    /** Whether to track tool usage */
+    trackToolUsage: boolean;
+    /** Whether to track session metrics */
+    trackSessionMetrics: boolean;
+    /** Retention period in days */
+    retentionDays: number;
+}
+export interface VimModeConfigType {
+    /** Whether vim keybindings are enabled */
+    enabled: boolean;
+    /** Show mode indicator in prompt */
+    showModeIndicator: boolean;
+    /** Bell on error in normal mode */
+    bellOnError: boolean;
+}
+export interface I18nConfigType {
+    /** Current locale code */
+    locale: string;
+    /** Fallback locale when key is missing */
+    fallbackLocale: string;
+    /** Auto-detect system language */
+    autoDetect: boolean;
+}
+export interface MultimodalConfigType {
+    /** Whether multimodal support is enabled */
+    enabled: boolean;
+    /** Max image file size in bytes */
+    maxImageSize: number;
+    /** Auto-detect image references in prompts */
+    autoDetectImages: boolean;
+}
+export interface VoiceConfigType {
+    /** Whether voice I/O is enabled */
+    enabled: boolean;
+    /** TTS engine */
+    ttsEngine: 'system' | 'espeak' | 'say' | 'auto';
+    /** STT engine */
+    sttEngine: 'system' | 'whisper' | 'auto';
+    /** Auto-speak assistant responses */
+    autoSpeak: boolean;
+    /** Language for TTS/STT */
+    language: string;
+}
+export interface APIServerConfigType {
+    /** Whether the API server is enabled */
+    enabled: boolean;
+    /** Host to bind to */
+    host: string;
+    /** Port to listen on */
+    port: number;
+    /** Whether authentication is required */
+    requireAuth: boolean;
+    /** Enable WebSocket support */
+    enableWebSocket: boolean;
+}
+export interface CloudSyncConfigType {
+    /** Whether cloud sync is enabled */
+    enabled: boolean;
+    /** Storage backend */
+    backend: 'gist' | 'local';
+    /** Auto-sync on session end */
+    autoSync: boolean;
+    /** Include session content in sync */
+    includeContent: boolean;
+}
+export interface DashboardConfigType {
+    /** Whether the web dashboard is enabled */
+    enabled: boolean;
+    /** Host to bind to */
+    host: string;
+    /** Port for dashboard server */
+    port: number;
+    /** Auto-open browser on start */
+    autoOpen: boolean;
+    /** Refresh interval for real-time updates (ms) */
+    refreshInterval: number;
+}
+export interface AutoModeConfigType {
+    /** Whether auto mode is enabled */
+    enabled: boolean;
+    /** Safety level for auto mode */
+    safetyLevel: 'conservative' | 'moderate' | 'aggressive';
+    /** Maximum iterations in auto mode */
+    maxIterations: number;
+    /** Maximum cost in USD (0 = unlimited) */
+    maxCost: number;
+    /** Maximum execution time in ms (0 = unlimited) */
+    maxTimeMs: number;
+    /** Commands that are always blocked */
+    blockedCommands: string[];
+    /** File patterns that cannot be modified */
+    blockedPatterns: string[];
+    /** Auto git commit after changes */
+    autoCommit: boolean;
+    /** Auto run tests after changes */
+    autoTest: boolean;
+    /** Pause on error */
+    pauseOnError: boolean;
+}
+export interface ScheduledTasksConfigType {
+    /** Whether scheduled tasks are enabled */
+    enabled: boolean;
+    /** Maximum concurrent scheduled tasks */
+    maxConcurrent: number;
+    /** Default interval unit */
+    defaultIntervalUnit: 'minutes' | 'hours' | 'days';
+    /** Whether to persist tasks across restarts */
+    persistTasks: boolean;
+    /** Directory for task persistence */
+    tasksDir: string;
+}
+export interface LintingConfigType {
+    /** Whether linting is enabled */
+    enabled: boolean;
+    /** Auto-run linter on file changes */
+    autoRunOnChange: boolean;
+    /** Auto-fix issues when possible */
+    autoFix: boolean;
+    /** Fail on lint errors */
+    failOnError: boolean;
+    /** Linter timeout in ms */
+    timeout: number;
+    /** File patterns to exclude */
+    excludePatterns: string[];
+}
+export interface TestingConfigType {
+    /** Whether testing integration is enabled */
+    enabled: boolean;
+    /** Auto-run tests on file changes */
+    autoRunOnChange: boolean;
+    /** Run tests on file save */
+    runOnSave: boolean;
+    /** Coverage threshold percentage */
+    coverageThreshold: number;
+    /** Test timeout in ms */
+    timeout: number;
+    /** Run only tests related to changed files */
+    relatedTestsOnly: boolean;
+}
+export interface CodeReviewConfigType {
+    /** Whether code review is enabled */
+    enabled: boolean;
+    /** Auto-review on file changes */
+    autoReviewOnChange: boolean;
+    /** Focus areas for review */
+    focusAreas: string[];
+    /** Minimum severity to report */
+    severityThreshold: 'critical' | 'major' | 'minor' | 'suggestion';
+    /** File patterns to exclude */
+    excludePatterns: string[];
+}
+export interface SecurityScannerConfigType {
+    /** Whether security scanning is enabled */
+    enabled: boolean;
+    /** Auto-scan on file changes */
+    autoScanOnChange: boolean;
+    /** Fail on this severity level */
+    failOnSeverity: 'critical' | 'high' | 'medium' | 'low';
+    /** File patterns to exclude */
+    excludePatterns: string[];
+    /** Custom security rules */
+    customRules: SecurityRuleType[];
+}
+export interface SecurityRuleType {
+    id: string;
+    name: string;
+    category: string;
+    severity: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    pattern: string;
+    description: string;
+    remediation: string;
+    cwe?: string;
+    owasp?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.js

@@ -0,0 +1,6 @@
+// ============================================================
+// NeuroCLI - Advanced AI Terminal Coding Assistant
+// Core Types & Interfaces - v4.0 with all new features
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/undo-redo.d.ts

@@ -0,0 +1,112 @@
+export interface UndoAction {
+    id: string;
+    type: 'file_create' | 'file_modify' | 'file_delete';
+    path: string;
+    timestamp: number;
+    /** Content before the change (used by modify / delete to restore). */
+    originalContent?: string;
+    /** Content after the change (used by create / modify to re-apply). */
+    newContent?: string;
+    description: string;
+}
+/** Shape accepted by {@link UndoRedoSystem.push} -- id and timestamp are generated. */
+export type UndoActionInput = Omit<UndoAction, 'id' | 'timestamp'>;
+/**
+ * Production-quality undo/redo system for NeuroCLI.
+ *
+ * Tracks file-level create, modify and delete operations so that any change
+ * can be rolled back (undo) or re-applied (redo). The redo stack is cleared
+ * automatically whenever a new action is pushed -- this mirrors the behaviour
+ * of most professional editors and prevents ambiguous redo states.
+ */
+export declare class UndoRedoSystem {
+    private undoStack;
+    private redoStack;
+    private totalUndos;
+    private totalRedos;
+    private totalActionsPushed;
+    /**
+     * Record a new action. The action is pushed onto the undo stack and the
+     * redo stack is cleared (standard expectation: a new edit invalidates
+     * previously undone changes).
+     */
+    push(action: UndoActionInput): void;
+    /**
+     * Undo the most recent action. Returns the undone action or `null` when
+     * there is nothing to undo. The action is moved from the undo stack to
+     * the redo stack and the file system change is reversed.
+     */
+    undo(): UndoAction | null;
+    /**
+     * Redo the most recently undone action. Returns the re-applied action or
+     * `null` when there is nothing to redo. The action is moved from the redo
+     * stack back to the undo stack and the file system change is re-applied.
+     */
+    redo(): UndoAction | null;
+    /**
+     * Undo up to `n` actions. Stops early if the undo stack is exhausted.
+     * Returns the list of actions that were undone (most-recent-first order --
+     * i.e. the first element is the action that was on top of the stack).
+     */
+    undoN(n: number): UndoAction[];
+    /**
+     * Redo up to `n` actions. Stops early if the redo stack is exhausted.
+     * Returns the list of actions that were re-applied (oldest-first order --
+     * i.e. the first element was the earliest undone action).
+     */
+    redoN(n: number): UndoAction[];
+    canUndo(): boolean;
+    canRedo(): boolean;
+    getUndoStack(): UndoAction[];
+    getRedoStack(): UndoAction[];
+    /**
+     * Returns a human-readable history combining both stacks.
+     *
+     * The undo entries are shown newest-first; the redo entries are shown
+     * oldest-first (which is the order in which they would be re-applied).
+     */
+    getHistory(): {
+        undo: UndoAction[];
+        redo: UndoAction[];
+    };
+    /**
+     * Clear both stacks. Cumulative stats counters are intentionally NOT
+     * reset so that `getStats()` retains a full session-level picture.
+     */
+    clear(): void;
+    getSize(): {
+        undo: number;
+        redo: number;
+    };
+    getStats(): {
+        totalUndos: number;
+        totalRedos: number;
+        totalActions: number;
+    };
+    /**
+     * Restore the file system to the state before `action` was performed.
+     *
+     * - **file_create**  : delete the created file.
+     * - **file_modify**  : restore `originalContent` (must be present).
+     * - **file_delete**  : re-create the file with `originalContent` (must be
+     *                      present).
+     */
+    applyUndo(action: UndoAction): void;
+    /**
+     * Re-apply a previously undone action to the file system.
+     *
+     * - **file_create**  : re-create the file with `newContent` (must be
+     *                      present).
+     * - **file_modify**  : write `newContent` (must be present).
+     * - **file_delete**  : delete the file again.
+     */
+    applyRedo(action: UndoAction): void;
+    /**
+     * Make sure the parent directory of `filePath` exists before writing.
+     */
+    private ensureDir;
+}
+export declare class UndoRedoError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=undo-redo.d.ts.map