@dianshuv/copilot-api 0.8.1 → 0.9.1

package/README.md

@@ -15,7 +15,6 @@
 - **Graceful shutdown**: 4-phase shutdown sequence — stops accepting requests, waits for in-flight requests to complete, sends abort signal, then force-closes. Configurable via `--shutdown-graceful-wait` and `--shutdown-abort-wait`.
 - **Stream repetition detection**: Detects when models get stuck in repetitive output loops using KMP-based pattern matching and logs a warning.
 - **Stale request reaping**: Automatically force-fails requests that exceed a configurable maximum age (default 600s) to prevent resource leaks.
-- **Gemini API compatibility**: `/v1beta/models` endpoints translate Gemini API requests to OpenAI format for Copilot. Enables Google Gemini CLI to use Copilot models via `GOOGLE_GEMINI_BASE_URL` environment variable.
 - **PostHog analytics**: Optional PostHog Cloud integration (`--posthog-key`) sends per-request token usage events for long-term trend analysis. Free tier (1M events/month) is more than sufficient for individual use.
 
 ## Quick Start
@@ -70,6 +69,7 @@ make down
 | `--github-token`, `-g` | Provide GitHub token directly | none |
 | `--claude-code`, `-c` | Generate Claude Code launch command | false |
 | `--show-token` | Show tokens on fetch/refresh | false |
+| `--show-all-models` | Show all upstream models including the hardcoded blacklist (see "Hidden Models" below) | false |
 | `--proxy-env` | Use proxy from environment | false |
 | `--no-history` | Disable request history UI at `/history` | false |
 | `--history-limit` | Max history entries in memory | 1000 |
@@ -81,6 +81,35 @@ make down
 | `--timezone-offset` | Timezone offset in hours from UTC for log timestamps (e.g., +8, -5, 0) | +8 |
 | `--posthog-key` | PostHog API key for token usage analytics (opt-in) | none |
 
+### Hidden Models
+
+By default the proxy hides 30 stale / duplicate / unused upstream model ids from
+its **listing surfaces** (`/v1/models`, the startup banner, and the
+`--claude-code` interactive prompts). Pass `--show-all-models` to see the full
+upstream catalogue.
+
+**Important**: this is a *display* filter only. The remaining POST endpoints
+(`/v1/chat/completions`, `/v1/messages`, `/v1/responses`) do **not** reject
+hidden ids — an explicit `POST` with a hidden id is still forwarded to
+upstream verbatim, even without `--show-all-models`. (The embedding and
+Gemini ids in the list have no callable endpoint in this proxy at all;
+they're hidden purely to denoise the `/v1/models` listing — the upstream
+`/models` catalogue still returns them.)
+
+To change the blacklist, edit `src/lib/hidden-models.ts` and re-publish (this
+fork uses `/publish`).
+
+Currently hidden (grouped):
+
+- **Legacy GPT** — `gpt-3.5-turbo`, `gpt-3.5-turbo-0613`, `gpt-4`, `gpt-4-0613`, `gpt-4-0125-preview`
+- **GPT-4o family** — `gpt-4o`, `gpt-4o-mini`, `gpt-4-o-preview`, `gpt-4o-2024-05-13`, `gpt-4o-2024-08-06`, `gpt-4o-2024-11-20`, `gpt-4o-mini-2024-07-18`
+- **GPT-4.1 family** — `gpt-4.1`, `gpt-4.1-2025-04-14`, `gpt-41-copilot`
+- **Older / smaller GPT-5** — `gpt-5-mini`, `gpt-5.3-codex`, `gpt-5.4`
+- **All embeddings** — `text-embedding-ada-002`, `text-embedding-3-small`, `text-embedding-3-small-inference`
+- **Older Gemini** — `gemini-2.5-pro`, `gemini-3-flash-preview`
+- **Older / variant Claude** — `claude-opus-4.5`, `claude-opus-4.6`, `claude-opus-4.7-high`, `claude-opus-4.7-xhigh`, `claude-sonnet-4.5`
+- **Special-purpose** — `mai-code-1-flash-internal`, `trajectory-compaction`
+
 ### Patch-Claude Command Options
 
 | Option | Description | Default |
@@ -98,7 +127,6 @@ make down
 |----------|--------|-------------|
 | `/v1/chat/completions` | POST | Chat completions |
 | `/v1/models` | GET | List available models |
-| `/v1/embeddings` | POST | Text embeddings |
 | `/v1/responses` | POST | Responses API (for codex models) |
 
 ### Anthropic Compatible
@@ -109,14 +137,6 @@ make down
 | `/v1/messages/count_tokens` | POST | Token counting |
 | `/v1/event_logging/batch` | POST | Event logging (no-op) |
 
-### Gemini Compatible
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/v1beta/models/{model}:generateContent` | POST | Non-streaming generation |
-| `/v1beta/models/{model}:streamGenerateContent` | POST | Streaming generation (SSE) |
-| `/v1beta/models/{model}:countTokens` | POST | Token counting |
-
 ### Utility
 
 | Endpoint | Method | Description |
@@ -146,8 +166,8 @@ Create `.claude/settings.json` in your project:
   "env": {
     "ANTHROPIC_BASE_URL": "http://localhost:4141",
     "ANTHROPIC_AUTH_TOKEN": "dummy",
-    "ANTHROPIC_MODEL": "gpt-4.1",
-    "ANTHROPIC_SMALL_FAST_MODEL": "gpt-4.1",
+    "ANTHROPIC_MODEL": "claude-opus-4.8",
+    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5",
     "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
     "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
   },
@@ -163,23 +183,6 @@ Or use the interactive setup:
 bun run start --claude-code
 ```
 
-## Using with Gemini CLI
-
-```bash
-# Start the proxy
-copilot-api start
-
-# Configure Gemini CLI to use the proxy
-export GEMINI_API_KEY="placeholder"
-export GOOGLE_GEMINI_BASE_URL="http://localhost:4141"
-
-# Basic conversation
-gemini -p "Explain this code"
-
-# Pipe review
-git diff HEAD~1 | gemini -p "Review this diff for bugs"
-```
-
 ## Upstream Project
 
 For the original project documentation, features, and updates, see: [ericc-ch/copilot-api](https://github.com/ericc-ch/copilot-api)