@involvex/prompt-enhancer 0.0.2

package/dist/lib/utils/models-cache.js

@@ -0,0 +1,139 @@
+/**
+ * Fetches and caches the models list from https://models.dev/api.json
+ * Cache TTL is 24 hours, stored at ~/.prompt-enhancer/models-cache.json
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { MODELS_CACHE_FILE } from './paths.js';
+import { KILO_MODELS } from '../providers/kilo.js';
+import { OPENCODE_MODELS_ENDPOINT, OPENCODE_DEFAULT_MODEL, } from '../providers/opencode.js';
+const MODELS_API_URL = 'https://models.dev/api.json';
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+async function loadCache() {
+    if (!existsSync(MODELS_CACHE_FILE))
+        return null;
+    try {
+        const raw = await readFile(MODELS_CACHE_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function fetchAndCache() {
+    const response = await fetch(MODELS_API_URL);
+    if (!response.ok) {
+        throw new Error(`models.dev fetch failed: ${response.status}`);
+    }
+    const data = (await response.json());
+    const cache = { fetchedAt: Date.now(), data };
+    try {
+        await writeFile(MODELS_CACHE_FILE, JSON.stringify(cache, null, 2), 'utf-8');
+    }
+    catch {
+        // Non-fatal: cache write failure just means we refetch next time
+    }
+    return data;
+}
+async function getModelsData() {
+    const cache = await loadCache();
+    if (cache && Date.now() - cache.fetchedAt < CACHE_TTL_MS) {
+        return cache.data;
+    }
+    try {
+        return await fetchAndCache();
+    }
+    catch {
+        // Network failure: return cached data even if stale, or empty
+        return cache?.data ?? {};
+    }
+}
+function extractModels(data, providerKeys) {
+    for (const key of providerKeys) {
+        const provider = data[key];
+        if (provider?.models) {
+            return Object.values(provider.models).map(m => ({
+                id: m.id ?? m.name,
+                name: m.name,
+            }));
+        }
+    }
+    return [];
+}
+/**
+ * Fetches available models directly from the OpenCode API.
+ * Falls back to a hardcoded list if the request fails.
+ */
+async function getOpenCodeModels(apiKey) {
+    const OPENCODE_FALLBACK = [
+        { id: OPENCODE_DEFAULT_MODEL, name: 'Claude Sonnet 4.5' },
+        { id: 'anthropic/claude-opus-4-5', name: 'Claude Opus 4.5' },
+        { id: 'anthropic/claude-haiku-4-5', name: 'Claude Haiku 4.5' },
+        { id: 'openai/gpt-4o', name: 'GPT-4o' },
+        { id: 'openai/gpt-4o-mini', name: 'GPT-4o mini' },
+        { id: 'google/gemini-2.5-flash', name: 'Gemini 2.5 Flash' },
+    ];
+    try {
+        const headers = {};
+        if (apiKey)
+            headers['Authorization'] = `Bearer ${apiKey}`;
+        const response = await fetch(OPENCODE_MODELS_ENDPOINT, { headers });
+        if (!response.ok)
+            return OPENCODE_FALLBACK;
+        const data = (await response.json());
+        if (!Array.isArray(data.data) || data.data.length === 0) {
+            return OPENCODE_FALLBACK;
+        }
+        return data.data
+            .map(m => ({
+            id: m.id,
+            name: m.id,
+        }))
+            .filter(m => m.id);
+    }
+    catch {
+        return OPENCODE_FALLBACK;
+    }
+}
+/**
+ * Falls back to a hardcoded list if network is unavailable.
+ */
+export async function getModelsForProvider(provider, apiKey) {
+    if (provider === 'opencode') {
+        return getOpenCodeModels(apiKey);
+    }
+    try {
+        const data = await getModelsData();
+        switch (provider) {
+            case 'gemini':
+                return extractModels(data, ['google']);
+            case 'copilot':
+                return extractModels(data, ['github', 'openai']);
+            case 'kilo':
+                // models.dev may not have a kilo key — fall through to hardcoded list
+                return KILO_MODELS;
+        }
+    }
+    catch {
+        // Fall through to defaults
+    }
+    // Hardcoded fallbacks
+    if (provider === 'kilo')
+        return KILO_MODELS;
+    if (provider === 'gemini') {
+        return [
+            { id: 'gemini-2.5-flash', name: 'Gemini 2.5 Flash' },
+            { id: 'gemini-2.5-pro', name: 'Gemini 2.5 Pro' },
+            { id: 'gemini-2.0-flash', name: 'Gemini 2.0 Flash' },
+            { id: 'gemini-1.5-pro', name: 'Gemini 1.5 Pro' },
+        ];
+    }
+    // copilot
+    return [
+        { id: 'gpt-4o', name: 'GPT-4o' },
+        { id: 'gpt-4o-mini', name: 'GPT-4o mini' },
+        { id: 'gpt-4.1', name: 'GPT-4.1' },
+        { id: 'claude-sonnet-4', name: 'Claude Sonnet 4' },
+        { id: 'o3', name: 'o3' },
+    ];
+}

package/dist/lib/utils/paths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utility functions for managing paths and file system operations
+ */
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare const HISTORY_FILE: string;
+export declare const MODELS_CACHE_FILE: string;
+export declare function getConfigPath(): string;
+export declare function getConfigFilePath(): string;
+export declare function getHistoryFilePath(): string;

package/dist/lib/utils/paths.js

@@ -0,0 +1,18 @@
+/**
+ * Utility functions for managing paths and file system operations
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+export const CONFIG_DIR = join(homedir(), '.prompt-enhancer');
+export const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export const HISTORY_FILE = join(CONFIG_DIR, 'history.json');
+export const MODELS_CACHE_FILE = join(CONFIG_DIR, 'models-cache.json');
+export function getConfigPath() {
+    return CONFIG_DIR;
+}
+export function getConfigFilePath() {
+    return CONFIG_FILE;
+}
+export function getHistoryFilePath() {
+    return HISTORY_FILE;
+}

package/package.json

@@ -0,0 +1,101 @@
+{
+	"name": "@involvex/prompt-enhancer",
+	"description": "A Cli to enhance your prompts",
+	"author": "involvex",
+	"version": "0.0.2",
+	"license": "MIT",
+	"bin": {
+		"prompt-enhancer": "dist/cli.js"
+	},
+	"type": "module",
+	"funding": {
+		"type": "github",
+		"url": "https://github.com/sponsors/involvex"
+	},
+	"sponsor": {
+		"url": "https://github.com/sponsors/involvex"
+	},
+	"repository": {
+		"url": "git+https://github.com/involvex/prompt-enhancer-cli.git",
+		"type": "git"
+	},
+	"engines": {
+		"node": ">=16"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "bun run src/cli.tsx",
+		"format": "prettier --write .",
+		"lint": "eslint src",
+		"lint:fix": "eslint src --fix",
+		"typecheck": "tsc --noEmit",
+		"prebuild": "bun run format && bun run lint:fix && bun run typecheck",
+		"test": "prettier --check . && xo && ava",
+		"changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
+		"compile": "bun run prebuild && bun build src/cli.tsx --compile --outfile dist/prompt-enhancer.exe",
+		"clean": "del-cli dist",
+		"release": "bun run clean && powershell -File scripts/release.ps1"
+	},
+	"files": [
+		"dist",
+		"readme.md",
+		"LICENSE",
+		".github/FUNDING.yml"
+	],
+	"dependencies": {
+		"@google/generative-ai": "^0.24.1",
+		"@types/ink": "^0.5.2",
+		"@types/meow": "^6.0.0",
+		"del-cli": "^7.0.0",
+		"has-flag": "^5.0.1",
+		"ink": "^5.0.0",
+		"ink-select-input": "^6.2.0",
+		"ink-text-input": "^6.0.0",
+		"meow": "^14.1.0",
+		"openai": "^6.27.0",
+		"react": "^18.3.1",
+		"react-devtools-core": "^7.0.1",
+		"react-dom": "^18.3.1",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@eslint/js": "latest",
+		"@sindresorhus/tsconfig": "^8.1.0",
+		"@types/react": "^18.0.32",
+		"@vdemedes/prettier-config": "^2.0.1",
+		"ava": "^5.2.0",
+		"chalk": "^5.2.0",
+		"conventional-changelog-cli": "^5.0.0",
+		"eslint": "latest",
+		"eslint-config-xo-react": "^0.29.0",
+		"eslint-plugin-react": "^7.32.2",
+		"eslint-plugin-react-hooks": "^7.0.1",
+		"ink-testing-library": "^4.0.0",
+		"jiti": "latest",
+		"prettier": "latest",
+		"prettier-plugin-organize-imports": "^4.3.0",
+		"prettier-plugin-packagejson": "^3.0.0",
+		"prettier-plugin-sort-imports": "^1.8.10",
+		"ts-node": "^10.9.1",
+		"typescript": "^5.0.3",
+		"typescript-eslint": "latest",
+		"xo": "^0.53.1"
+	},
+	"ava": {
+		"extensions": {
+			"ts": "module",
+			"tsx": "module"
+		},
+		"nodeArguments": [
+			"--loader=ts-node/esm"
+		]
+	},
+	"xo": {
+		"extends": "xo-react",
+		"prettier": true,
+		"rules": {
+			"react/prop-types": "off"
+		}
+	},
+	"prettier": "@vdemedes/prettier-config"
+}

package/readme.md

@@ -0,0 +1,271 @@
+# prompt-enhancer
+
+> CLI/TUI tool to enhance prompts using various LLM providers (Gemini, Copilot, Kilo-gateway, Opencode Zen)
+
+**Status**: ✅ MVP Complete - Phase 4 Interactive TUI Ready for Use
+
+## Features
+
+- 🎯 **Interactive TUI Mode** - Menu-driven interface for prompt enhancement
+- ⚡ **CLI Mode** - Direct enhancement via command-line flags
+- 🔧 **Multi-Provider Support** - Gemini, Copilot, Kilo-gateway
+- 💾 **Config Management** - Persistent settings at `~/.prompt-enhancer/`
+- 📜 **History Tracking** - Browse past enhancements
+- 🔄 **Streaming Output** - Real-time enhanced prompt display
+- 🎨 **Interactive Settings** - Configure providers via TUI
+
+## Install
+
+```bash
+npm install --global prompt-enhancer
+```
+
+Or use directly:
+
+```bash
+npx prompt-enhancer
+```
+
+## Quick Start
+
+### Interactive TUI Mode (Default)
+
+```bash
+prompt-enhancer
+```
+
+This launches the interactive menu where you can:
+
+- Enhance a prompt
+- Configure provider settings
+- View enhancement history
+- Get help
+
+### CLI Mode - Direct Enhancement
+
+```bash
+$ prompt-enhancer --prompt "Your prompt here"
+# or shorter
+$ prompt-enhancer -p "Your prompt here"
+```
+
+## Configuration
+
+### Setting Up Providers
+
+1. **Via TUI Settings Menu** (Interactive):
+
+   ```bash
+   $ prompt-enhancer
+   # Select "Settings" → Choose provider → Enter API Key → Select Model
+   ```
+
+2. **Manual Config File**:
+   Edit `~/.prompt-enhancer/config.json`:
+
+   ```json
+   {
+   	"version": "0.1.0",
+   	"providers": {
+   		"gemini": {
+   			"name": "gemini",
+   			"apiKey": "your-api-key",
+   			"model": "gemini-2.5-flash",
+   			"enabled": true
+   		},
+   		"copilot": {
+   			"name": "copilot",
+   			"apiKey": "your-api-key",
+   			"model": "gpt-4o",
+   			"enabled": true
+   		},
+   		"kilo": {
+   			"name": "kilo",
+   			"apiKey": "your-api-key",
+   			"model": "auto",
+   			"enabled": true
+   		}
+   	},
+   	"defaultProvider": "gemini",
+   	"maxTokens": 500,
+   	"temperature": 1.0,
+   	"saveHistory": true,
+   	"streaming": true,
+   	"theme": "dark"
+   }
+   ```
+
+## Usage Examples
+
+### Interactive Enhancement
+
+```bash
+$ prompt-enhancer
+# Select "Enhance Prompt" → Type your prompt → Choose provider → View result
+```
+
+### Quick CLI Enhancement
+
+```bash
+prompt-enhancer -p "write a hello world program"
+```
+
+### View Enhancement History
+
+```bash
+$ prompt-enhancer
+# Select "View History" to browse past enhancements
+```
+
+### Get Help
+
+```bash
+$ prompt-enhancer --help
+$ prompt-enhancer
+# Select "Help" in menu for interactive guide
+```
+
+## Supported Models
+
+### Gemini
+
+- `gemini-2.5-flash` (default)
+- `gemini-2.0-pro`
+- `gemini-1.5-flash`
+- `gemini-1.5-pro`
+
+### Copilot / OpenAI
+
+- `gpt-4o` (default)
+- `gpt-4.1`
+- `gpt-4-turbo`
+- `gpt-3.5-turbo`
+
+### Kilo Gateway
+
+- `auto` (default) - Automatically routes to best available free model
+- Any model supported by Kilo's router
+
+## Configuration Files
+
+- **Config**: `~/.prompt-enhancer/config.json` - Provider settings, API keys, preferences
+- **History**: `~/.prompt-enhancer/history.json` - Enhancement history with timestamps
+
+## API Keys Setup
+
+### Gemini
+
+Get your API key at: <https://makersuite.google.com/app/apikey>
+
+### OpenAI / Copilot
+
+Get your API key at: <https://platform.openai.com/api-keys>
+
+### Kilo Gateway
+
+Get your key at: <https://kilo.dev> (or use free models with no key)
+
+## Commands
+
+```
+$ prompt-enhancer --help
+
+  Usage
+    $ prompt-enhancer
+
+  Options
+    --prompt, -p    Your prompt to enhance (optional)
+    --help, -h      Show help
+    --version, -v   Show version
+
+  Examples
+    $ prompt-enhancer
+    $ prompt-enhancer -p "build a cli to enhance prompts"
+    $ prompt-enhancer --help
+```
+
+## Architecture
+
+### Project Structure
+
+```
+src/
+├── cli.tsx                 # CLI entry point and routing
+├── app.tsx                 # Interactive TUI main app
+├── commands/               # Command implementations
+│   ├── direct-enhance.tsx  # CLI enhancement
+│   ├── about.tsx
+│   ├── help.tsx
+│   └── version.tsx
+├── components/             # React/Ink TUI components
+│   ├── enhance-prompt.tsx  # Interactive enhancement UI
+│   ├── settings.tsx        # Provider configuration UI
+│   ├── history-viewer.tsx  # History browsing UI
+│   └── menu.tsx            # Menu component
+└── lib/                    # Core libraries
+    ├── providers/          # Provider implementations
+    │   ├── gemini.ts
+    │   ├── copilot.ts
+    │   ├── kilo.ts
+    │   ├── base.ts         # Abstract base provider
+    │   └── index.ts        # Provider registry
+    ├── config/             # Configuration management
+    │   ├── manager.ts      # Config read/write
+    │   ├── schema.ts       # Zod validation
+    │   └── types.ts        # TypeScript types
+    ├── enhancement/        # Enhancement engine
+    │   └── engine.ts       # Streaming enhancement logic
+    ├── history/            # History management
+    │   └── manager.ts      # History persistence
+    └── utils/              # Utilities
+```
+
+## Development
+
+### Build
+
+```bash
+bun run build
+```
+
+### Lint & Format
+
+```bash
+bun run lint
+bun run format
+```
+
+### Type Check
+
+```bash
+bun run typecheck
+```
+
+### Full Build Pipeline
+
+```bash
+bun run build  # Runs format, lint, typecheck, then compile
+```
+
+## Technology Stack
+
+- **React 18** - Component framework
+- **Ink 5.2.1** - Terminal UI rendering
+- **TypeScript** - Type safety
+- **Zod** - Schema validation
+- **Meow** - CLI argument parsing
+- **Provider SDKs**:
+  - `@google/generative-ai` - Gemini API
+  - `openai` - OpenAI/Copilot API
+  - Custom HTTP client for Kilo
+
+## Notes
+
+- Configuration is stored locally in `~/.prompt-enhancer/`
+- API keys are stored unencrypted in config.json (consider using environment variables for production)
+- History is automatically saved unless disabled in config
+- Streaming output requires provider and model support
+
+## License
+
+MIT