4.8 KiB
User Input (Tab×2 or CLI) ↓ ┌───────────────────────────────────────┐ │ Entry Points │ ├───────────────────────────────────────┤ │ • _finishsh() - Tab completion │ │ • command_command() - CLI mode │ └───────────────┬───────────────────────┘ ↓ ┌───────────────────────────────────────┐ │ Configuration Layer │ ├───────────────────────────────────────┤ │ acsh_load_config() │ │ • Read ~/.finish/config │ │ • Set ACSH_PROVIDER, ACSH_ENDPOINT │ │ • Set ACSH_ACTIVE_API_KEY (if needed) │ └───────────────┬───────────────────────┘ ↓ ┌───────────────────────────────────────┐ │ Cache Layer │ ├───────────────────────────────────────┤ │ • Check cache_dir/acsh-{hash}.txt │ │ • Return cached completions if exists │ └───────────────┬───────────────────────┘ ↓ (cache miss) ┌───────────────────────────────────────┐ │ Context Builder │ ├───────────────────────────────────────┤ │ _build_prompt() │ │ • Command history (sanitized) │ │ • Terminal info (env vars, cwd) │ │ • Recent files (ls -ld) │ │ • Help message (cmd --help) │ └───────────────┬───────────────────────┘ ↓ ┌───────────────────────────────────────┐ │ Payload Builder │ ├───────────────────────────────────────┤ │ _build_payload() │ │ • Format: {model, messages, temp} │ │ • Provider-specific options: │ │ - Ollama: {format:"json"} │ │ - LMStudio: {stream:true} │ │ - OpenAI: {response_format} │ └───────────────┬───────────────────────┘ ↓ ┌───────────────────────────────────────┐ │ LLM Provider Layer │ ├───────────────────────────────────────┤ │ openai_completion() │ │ • curl to endpoint │ │ • Ollama: no auth header │ │ • Others: Authorization header if key │ │ • Parse response (JSON/streaming) │ └───────────────┬───────────────────────┘ ↓ ┌───────────────────────────────────────┐ │ Response Parser │ ├───────────────────────────────────────┤ │ • Extract completions array │ │ • Fallback parsing for non-JSON │ │ • Filter command-like lines │ └───────────────┬───────────────────────┘ ↓ ┌───────────────────────────────────────┐ │ Output Layer │ ├───────────────────────────────────────┤ │ • Write to cache │ │ • Log usage (tokens, cost) │ │ • Return COMPREPLY array (completion) │ │ • or stdout (CLI mode) │ └───────────────────────────────────────┘