bashbros 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -15,8 +15,9 @@ interface BashBrosConfig {
     undo: UndoPolicy;
     ward: WardPolicy;
     dashboard: DashboardPolicy;
+    sessionStart: SessionStartConfig;
 }
-type AgentType = 'claude-code' | 'clawdbot' | 'moltbot' | 'gemini-cli' | 'aider' | 'opencode' | 'custom';
+type AgentType = 'claude-code' | 'clawdbot' | 'moltbot' | 'gemini-cli' | 'copilot-cli' | 'aider' | 'opencode' | 'custom';
 interface MoltbotGatewayInfo {
     port: number;
     host: string;
@@ -117,9 +118,11 @@ interface CommandResult {
     violations: PolicyViolation[];
 }
 interface PolicyViolation {
-    type: 'command' | 'path' | 'secrets' | 'rate_limit';
+    type: 'command' | 'path' | 'secrets' | 'rate_limit' | 'risk_score' | 'loop' | 'anomaly' | 'output';
     rule: string;
     message: string;
+    remediation?: string[];
+    severity?: 'low' | 'medium' | 'high' | 'critical';
 }
 interface AuditEntry {
     timestamp: Date;
@@ -156,6 +159,12 @@ interface DashboardPolicy {
     port: number;
     bind: string;
 }
+interface SessionStartConfig {
+    enabled: boolean;
+    collectMetadata: boolean;
+    ollamaStatus: boolean;
+    preloadContext: boolean;
+}
 
 declare class BashBros extends EventEmitter {
     private config;
@@ -311,6 +320,105 @@ declare class SystemProfiler {
     toContext(): string;
 }
 
+/**
+ * Simple Ollama client for local model inference.
+ * Keeps it minimal - just what we need for Bash Bro.
+ */
+interface OllamaConfig {
+    host: string;
+    model: string;
+    timeout: number;
+}
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+interface ModelInfo {
+    modelfile: string;
+    parameters: string;
+    template: string;
+    details: {
+        parent_model: string;
+        format: string;
+        family: string;
+        families: string[];
+        parameter_size: string;
+        quantization_level: string;
+    };
+}
+interface RunningModel {
+    name: string;
+    model: string;
+    size: number;
+    size_vram: number;
+    digest: string;
+    details: {
+        family: string;
+        parameter_size: string;
+        quantization_level: string;
+    };
+    expires_at: string;
+}
+declare class OllamaClient {
+    private config;
+    constructor(config?: Partial<OllamaConfig>);
+    /**
+     * Check if Ollama is running and accessible
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * List available models
+     */
+    listModels(): Promise<string[]>;
+    /**
+     * Generate a response from the model
+     */
+    generate(prompt: string, systemPrompt?: string): Promise<string>;
+    /**
+     * Chat with the model (multi-turn conversation)
+     */
+    chat(messages: ChatMessage[]): Promise<string>;
+    /**
+     * Ask Bash Bro to suggest a command
+     */
+    suggestCommand(context: string): Promise<string | null>;
+    /**
+     * Show detailed info about a model
+     */
+    showModel(name: string): Promise<ModelInfo | null>;
+    /**
+     * Delete a model
+     */
+    deleteModel(name: string): Promise<boolean>;
+    /**
+     * List currently running models
+     */
+    listRunning(): Promise<RunningModel[]>;
+    /**
+     * Pull a model from the registry
+     */
+    pullModel(name: string): Promise<boolean>;
+    /**
+     * Create a model from a Modelfile
+     */
+    createModel(name: string, modelfile: string): Promise<boolean>;
+    setModel(model: string): void;
+    getModel(): string;
+    /**
+     * Analyze command safety and provide recommendations
+     */
+    analyzeCommandSafety(command: string): Promise<{
+        safe: boolean;
+        risk: 'low' | 'medium' | 'high' | 'critical';
+        explanation: string;
+        suggestions: string[];
+    }>;
+    /**
+     * Generate with a temporary model override (for adapter-specific calls)
+     */
+    generateWithAdapter(modelOverride: string, prompt: string, systemPrompt?: string): Promise<string>;
+}
+
 type RouteDecision = 'bro' | 'main' | 'both';
 interface RoutingResult {
     decision: RouteDecision;
@@ -320,9 +428,11 @@ interface RoutingResult {
 declare class TaskRouter {
     private rules;
     private profile;
-    constructor(profile?: SystemProfile | null);
+    private ollama;
+    constructor(profile?: SystemProfile | null, ollama?: OllamaClient | null);
     private buildDefaultRules;
     route(command: string): RoutingResult;
+    routeAsync(command: string): Promise<RoutingResult>;
     private looksSimple;
     addRule(pattern: RegExp, route: RouteDecision, reason: string): void;
     updateProfile(profile: SystemProfile): void;
@@ -338,9 +448,12 @@ declare class CommandSuggester {
     private history;
     private profile;
     private patterns;
-    constructor(profile?: SystemProfile | null);
+    private ollama;
+    private aiCache;
+    constructor(profile?: SystemProfile | null, ollama?: OllamaClient | null);
     private initPatterns;
     suggest(context: SuggestionContext): Suggestion[];
+    suggestAsync(context: SuggestionContext): Promise<Suggestion[]>;
     private suggestFromPatterns;
     private suggestFromHistory;
     private suggestFromContext;
@@ -381,6 +494,23 @@ declare class BackgroundWorker extends EventEmitter {
     formatStatus(): string;
 }
 
+type AdapterPurpose = 'suggest' | 'safety' | 'route' | 'explain' | 'fix' | 'script' | 'general';
+interface AdapterEntry {
+    name: string;
+    baseModel: string;
+    purpose: AdapterPurpose;
+    adapterPath: string;
+    trainedAt: string;
+    tracesUsed: number;
+    qualityScore: number;
+}
+
+interface ModelProfile {
+    name: string;
+    baseModel: string;
+    adapters: Partial<Record<AdapterPurpose, string>>;
+}
+
 interface BroConfig {
     modelEndpoint?: string;
     modelName?: string;
@@ -389,6 +519,7 @@ interface BroConfig {
     enableBackground?: boolean;
     enableOllama?: boolean;
     enableBashgymIntegration?: boolean;
+    activeProfile?: string;
 }
 declare class BashBro extends EventEmitter {
     private profiler;
@@ -400,6 +531,9 @@ declare class BashBro extends EventEmitter {
     private config;
     private ollamaAvailable;
     private bashgymModelVersion;
+    private adapterRegistry;
+    private profileManager;
+    private activeProfile;
     constructor(config?: BroConfig);
     /**
      * Initialize bashgym integration for model hot-swap
@@ -414,6 +548,14 @@ declare class BashBro extends EventEmitter {
     scanProject(projectPath: string): void;
     route(command: string): RoutingResult;
     suggest(context: SuggestionContext): Suggestion[];
+    /**
+     * AI-enhanced async routing - uses pattern matching first, falls back to Ollama
+     */
+    routeAsync(command: string): Promise<RoutingResult>;
+    /**
+     * AI-enhanced async suggestions - pattern matching + Ollama suggestions with caching
+     */
+    suggestAsync(context: SuggestionContext): Promise<Suggestion[]>;
     /**
      * SECURITY FIX: Safe command execution with validation
      */
@@ -431,22 +573,10 @@ declare class BashBro extends EventEmitter {
      * Ask Bash Bro (via Ollama) to suggest the next command
      */
     aiSuggest(context: string): Promise<string | null>;
-    /**
-     * Ask Bash Bro to explain a command
-     */
-    aiExplain(command: string): Promise<string>;
-    /**
-     * Ask Bash Bro to fix a failed command
-     */
-    aiFix(command: string, error: string): Promise<string | null>;
     /**
      * Set the Ollama model to use
      */
     setModel(model: string): void;
-    /**
-     * Generate a shell script from natural language description
-     */
-    aiGenerateScript(description: string): Promise<string | null>;
     /**
      * Analyze command for security risks using AI
      */
@@ -456,22 +586,6 @@ declare class BashBro extends EventEmitter {
         explanation: string;
         suggestions: string[];
     }>;
-    /**
-     * Summarize a terminal session
-     */
-    aiSummarize(commands: {
-        command: string;
-        output?: string;
-        error?: string;
-    }[]): Promise<string>;
-    /**
-     * Get AI help for a topic or command
-     */
-    aiHelp(topic: string): Promise<string>;
-    /**
-     * Convert natural language to command
-     */
-    aiToCommand(description: string): Promise<string | null>;
     /**
      * Get bashgym sidekick model version (if using)
      */
@@ -484,84 +598,27 @@ declare class BashBro extends EventEmitter {
      * Force refresh the bashgym model (check for updates)
      */
     refreshBashgymModel(): boolean;
-    status(): string;
-}
-
-/**
- * Simple Ollama client for local model inference.
- * Keeps it minimal - just what we need for Bash Bro.
- */
-interface OllamaConfig {
-    host: string;
-    model: string;
-    timeout: number;
-}
-interface ChatMessage {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}
-declare class OllamaClient {
-    private config;
-    constructor(config?: Partial<OllamaConfig>);
     /**
-     * Check if Ollama is running and accessible
+     * Get model name for a specific purpose (checks active profile for adapter override)
      */
-    isAvailable(): Promise<boolean>;
+    private getModelForPurpose;
     /**
-     * List available models
+     * Get discovered LoRA adapters
      */
-    listModels(): Promise<string[]>;
+    getAdapters(): AdapterEntry[];
     /**
-     * Generate a response from the model
+     * Get available model profiles
      */
-    generate(prompt: string, systemPrompt?: string): Promise<string>;
-    /**
-     * Chat with the model (multi-turn conversation)
-     */
-    chat(messages: ChatMessage[]): Promise<string>;
+    getProfiles(): ModelProfile[];
     /**
-     * Ask Bash Bro to suggest a command
+     * Get the active model profile
      */
-    suggestCommand(context: string): Promise<string | null>;
+    getActiveProfile(): ModelProfile | null;
     /**
-     * Ask Bash Bro to explain a command
+     * Set the active model profile by name
      */
-    explainCommand(command: string): Promise<string>;
-    /**
-     * Ask Bash Bro to fix a command that failed
-     */
-    fixCommand(command: string, error: string): Promise<string | null>;
-    setModel(model: string): void;
-    getModel(): string;
-    /**
-     * Generate a shell script from a natural language description
-     */
-    generateScript(description: string, shell?: string): Promise<string | null>;
-    /**
-     * Analyze command safety and provide recommendations
-     */
-    analyzeCommandSafety(command: string): Promise<{
-        safe: boolean;
-        risk: 'low' | 'medium' | 'high' | 'critical';
-        explanation: string;
-        suggestions: string[];
-    }>;
-    /**
-     * Summarize a series of commands and their outputs
-     */
-    summarizeSession(commands: {
-        command: string;
-        output?: string;
-        error?: string;
-    }[]): Promise<string>;
-    /**
-     * Get help for a specific tool or command
-     */
-    getHelp(topic: string): Promise<string>;
-    /**
-     * Convert natural language to a command
-     */
-    naturalToCommand(description: string): Promise<string | null>;
+    setActiveProfile(name: string): boolean;
+    status(): string;
 }
 
 /**
@@ -731,6 +788,7 @@ declare class CommandFilter {
     private blockPatterns;
     constructor(policy: CommandPolicy);
     check(command: string): PolicyViolation | null;
+    private extractBase;
     private globToRegex;
 }
 
@@ -751,10 +809,22 @@ declare class PathSandbox {
     isSymlinkEscape(path: string): boolean;
 }
 
+interface TextScanFinding {
+    pattern: string;
+    redacted: string;
+    line: number;
+    severity: 'high' | 'critical';
+}
+interface TextScanResult {
+    clean: boolean;
+    findings: TextScanFinding[];
+}
 declare class SecretsGuard {
     private policy;
     private patterns;
+    private static readonly TEXT_PATTERNS;
     constructor(policy: SecretsPolicy);
+    scanText(text: string): TextScanResult;
     check(command: string, paths: string[]): PolicyViolation | null;
     /**
      * SECURITY FIX: Detect base64/hex encoded secret access
@@ -1017,6 +1087,10 @@ declare class ReportGenerator {
     static oneLine(metrics: SessionMetrics): string;
 }
 
+declare function startMCPServer(): Promise<void>;
+
+type CapabilityTier = 'basic' | 'moderate' | 'advanced';
+
 /**
  * Claude Code Hook Integration
  * Seamlessly integrate BashBros with Claude Code
@@ -1026,7 +1100,13 @@ interface ClaudeSettings {
         PreToolUse?: HookConfig[];
         PostToolUse?: HookConfig[];
         SessionEnd?: HookConfig[];
+        SessionStart?: HookConfig[];
+        UserPromptSubmit?: HookConfig[];
     };
+    mcpServers?: Record<string, {
+        command: string;
+        args: string[];
+    }>;
     [key: string]: unknown;
 }
 interface HookConfig {
@@ -1067,6 +1147,10 @@ declare class ClaudeCodeHooks {
      * Check if BashBros hooks are installed
      */
     static isInstalled(settings?: ClaudeSettings): boolean;
+    /**
+     * Check if MCP server config is installed
+     */
+    static isMCPInstalled(settings?: ClaudeSettings): boolean;
     /**
      * Get hook status
      */
@@ -1074,6 +1158,8 @@ declare class ClaudeCodeHooks {
         claudeInstalled: boolean;
         hooksInstalled: boolean;
         allToolsInstalled: boolean;
+        promptHookInstalled: boolean;
+        mcpInstalled: boolean;
         hooks: string[];
     };
     /**
@@ -1094,6 +1180,24 @@ declare class ClaudeCodeHooks {
         success: boolean;
         message: string;
     };
+    /**
+     * Check if prompt recording hook is installed
+     */
+    static isPromptHookInstalled(settings?: ClaudeSettings): boolean;
+    /**
+     * Install prompt recording hook (records user prompt submissions)
+     */
+    static installPromptHook(): {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Uninstall prompt recording hook
+     */
+    static uninstallPromptHook(): {
+        success: boolean;
+        message: string;
+    };
 }
 /**
  * Gate command - called by PreToolUse hook
@@ -1514,4 +1618,4 @@ declare class BashgymIntegration extends EventEmitter {
 declare function getBashgymIntegration(): BashgymIntegration;
 declare function resetBashgymIntegration(): void;
 
-export { type AgentType, type Anomaly, type AnomalyConfig, type AnomalyDetectionPolicy, AnomalyDetector, type AuditEntry, AuditLogger, type AuditPolicy, type BackgroundTask, BackgroundWorker, BashBro, BashBros, type BashBrosConfig, BashgymIntegration, type BroConfig, type CaptureMode, ClaudeCodeHooks, type ClaudeSettings, CommandFilter, type CommandMetric, type CommandPolicy, type CommandResult, CommandSuggester, type CostEstimate, CostEstimator, type Finding, type IntegrationSettings, type LoopAlert, type LoopConfig, type LoopDetectionPolicy, LoopDetector, MetricsCollector, type ModelManifest, type ModelPricing, type ModelVersion, type MoltbotGatewayInfo, type MoltbotGatewayStatus, MoltbotHooks, type MoltbotSecurityAuditResult, type MoltbotSecurityFinding, type MoltbotSessionContext, type MoltbotSettings, type MoltbotStatus, OllamaClient, type OllamaInfo, OutputScanner, type OutputScanningPolicy, type PathPolicy, PathSandbox, PolicyEngine, type PolicyViolation, type RateLimitPolicy, RateLimiter, ReportGenerator, type ReportOptions, type RiskPattern, type RiskScore, RiskScorer, type RiskScoringPolicy, type RouteDecision, type RoutingResult, type ScanResult, SecretsGuard, type SecretsPolicy, type SecurityProfile, type SessionMetrics, type Suggestion, type SuggestionContext, type SystemProfile, SystemProfiler, TaskRouter, type TraceData, type TraceStep, type TrainingTrigger, type UndoConfig, type UndoEntry, type UndoPolicy, type UndoResult, UndoStack, type VersionInfo, allowForSession, clearSessionAllowlist, detectMoltbotSession, gateCommand, getBashgymIntegration, getMoltbotAgentName, getMoltbotHooks, getMoltbotSessionId, getSessionAllowlist, isAllowedForSession, isInMoltbotSession, isSandboxEnabled, loadConfig, resetBashgymIntegration };
+export { type AgentType, type Anomaly, type AnomalyConfig, type AnomalyDetectionPolicy, AnomalyDetector, type AuditEntry, AuditLogger, type AuditPolicy, type BackgroundTask, BackgroundWorker, BashBro, BashBros, type BashBrosConfig, BashgymIntegration, type BroConfig, type CapabilityTier, type CaptureMode, ClaudeCodeHooks, type ClaudeSettings, CommandFilter, type CommandMetric, type CommandPolicy, type CommandResult, CommandSuggester, type CostEstimate, CostEstimator, type Finding, type IntegrationSettings, type LoopAlert, type LoopConfig, type LoopDetectionPolicy, LoopDetector, MetricsCollector, type ModelManifest, type ModelPricing, type ModelVersion, type MoltbotGatewayInfo, type MoltbotGatewayStatus, MoltbotHooks, type MoltbotSecurityAuditResult, type MoltbotSecurityFinding, type MoltbotSessionContext, type MoltbotSettings, type MoltbotStatus, OllamaClient, type OllamaInfo, OutputScanner, type OutputScanningPolicy, type PathPolicy, PathSandbox, PolicyEngine, type PolicyViolation, type RateLimitPolicy, RateLimiter, ReportGenerator, type ReportOptions, type RiskPattern, type RiskScore, RiskScorer, type RiskScoringPolicy, type RouteDecision, type RoutingResult, type ScanResult, SecretsGuard, type SecretsPolicy, type SecurityProfile, type SessionMetrics, type Suggestion, type SuggestionContext, type SystemProfile, SystemProfiler, TaskRouter, type TraceData, type TraceStep, type TrainingTrigger, type UndoConfig, type UndoEntry, type UndoPolicy, type UndoResult, UndoStack, type VersionInfo, allowForSession, clearSessionAllowlist, detectMoltbotSession, gateCommand, getBashgymIntegration, getMoltbotAgentName, getMoltbotHooks, getMoltbotSessionId, getSessionAllowlist, isAllowedForSession, isInMoltbotSession, isSandboxEnabled, loadConfig, resetBashgymIntegration, startMCPServer };