tokenmix 0.4.7 → 0.4.8

package/README.md

@@ -4,6 +4,15 @@ Zero-config CLI to use any open-source coding agent with [TokenMix](https://toke
 
 One account, one balance, 160+ models routed automatically across Claude / GPT / Gemini / DeepSeek / Qwen / Moonshot / ...
 
+## Why TokenMix
+
+Behind the zero-config CLI is a gateway built to be the **honest, transparent** LLM backend for BYOK coding agents:
+
+- **Transparent, real-time billing.** `tokenmix balance` shows your actual balance, gift credit, and total spent — to micro-USD precision, not opaque "credits". `tokenmix models` lists every model's real price (free models show `$0`, not a dash).
+- **Prompt caching that saves you money — automatically.** Cache hits bill at the discounted rate with nothing to configure: OpenAI / DeepSeek / Gemini / Qwen via their `cached_tokens`, Anthropic via `cache_control` pass-through (cache reads ≈10% of the input price). The savings are yours, and you can see them.
+- **One key, every protocol.** OpenAI Chat Completions, Anthropic Messages, and the Responses API — all on one account, which is why every agent below (terminal and editor alike) runs on a single balance.
+- **Non-invasive by design.** Configuring an agent never clobbers your setup: your Claude settings are backed up and restored, Codex's provider is injected at launch (your `~/.codex/config.toml` stays untouched), and `tokenmix logout` reverts everything. Credentials are stored locally at `0600`.
+
 ## Quick Start
 
 ```bash

package/dist/commands/models.js

@@ -31,9 +31,20 @@ export function formatPrice(p) {
         return '0';
     return p.toFixed(6).replace(/\.?0+$/, '');
 }
+// Apply --type and --search filters. Exported for unit testing.
+export function filterModels(all, opts) {
+    let r = all;
+    if (opts.type)
+        r = r.filter((m) => m.model_type === opts.type);
+    if (opts.search) {
+        const kw = opts.search.toLowerCase();
+        r = r.filter((m) => (m.short_id || m.model_id || '').toLowerCase().includes(kw));
+    }
+    return r;
+}
 export async function modelsCommand(opts) {
     const all = await listPublicModels();
-    const filtered = opts.type ? all.filter((m) => m.model_type === opts.type) : all;
+    const filtered = filterModels(all, opts);
     if (filtered.length === 0) {
         logger.warn(t('models.none'));
         return;
@@ -45,6 +56,8 @@ export async function modelsCommand(opts) {
         grouped.set(m.model_type, list);
     }
     for (const [type, list] of grouped) {
+        // Stable, readable order within a type (the API order is arbitrary).
+        list.sort((a, b) => (a.short_id || a.model_id || '').localeCompare(b.short_id || b.model_id || ''));
         console.log();
         console.log(chalk.bold(`${typeLabel(type)}  (${list.length})`));
         for (const m of list) {

package/dist/i18n/messages.js

@@ -145,6 +145,7 @@ export const en = {
     'cmd.topup': 'Open the browser to top up your account',
     'cmd.models': 'List available models with prices',
     'cmd.modelsType': 'Filter by type: chat | embedding | image | audio | video',
+    'cmd.modelsSearch': 'Filter models by name (substring match)',
     'cmd.list': 'List supported coding agents',
     'cmd.doctor': 'Diagnose CLI configuration and agent installation',
     'cmd.agent': 'Configure and launch {name} via TokenMix',
@@ -294,6 +295,7 @@ export const zh = {
     'cmd.topup': '打开浏览器为账户充值',
     'cmd.models': '列出可用模型及价格',
     'cmd.modelsType': '按类型筛选：chat | embedding | image | audio | video',
+    'cmd.modelsSearch': '按名称筛选模型（子串匹配）',
     'cmd.list': '列出支持的编程 agent',
     'cmd.doctor': '诊断 CLI 配置与 agent 安装情况',
     'cmd.agent': '通过 TokenMix 配置并启动 {name}',
@@ -428,6 +430,7 @@ export const ja = {
     'cmd.topup': 'ブラウザを開いてアカウントにチャージ',
     'cmd.models': '利用可能なモデルと価格を一覧表示',
     'cmd.modelsType': 'タイプで絞り込み：chat | embedding | image | audio | video',
+    'cmd.modelsSearch': '名前でモデルを絞り込み（部分一致）',
     'cmd.list': '対応しているコーディング agent を一覧表示',
     'cmd.doctor': 'CLI 設定と agent のインストール状況を診断',
     'cmd.agent': 'TokenMix 経由で {name} を設定して起動',
@@ -562,6 +565,7 @@ export const ko = {
     'cmd.topup': '브라우저를 열어 계정 충전',
     'cmd.models': '사용 가능한 모델과 가격 목록 표시',
     'cmd.modelsType': '유형으로 필터링: chat | embedding | image | audio | video',
+    'cmd.modelsSearch': '이름으로 모델 필터링 (부분 일치)',
     'cmd.list': '지원하는 코딩 agent 목록 표시',
     'cmd.doctor': 'CLI 구성과 agent 설치 상태 진단',
     'cmd.agent': 'TokenMix를 통해 {name} 구성 및 실행',
@@ -696,6 +700,7 @@ export const es = {
     'cmd.topup': 'Abre el navegador para recargar tu cuenta',
     'cmd.models': 'Lista los modelos disponibles con precios',
     'cmd.modelsType': 'Filtrar por tipo: chat | embedding | image | audio | video',
+    'cmd.modelsSearch': 'Filtrar modelos por nombre (coincidencia parcial)',
     'cmd.list': 'Lista los agents de programación compatibles',
     'cmd.doctor': 'Diagnostica la configuración de la CLI y la instalación de los agents',
     'cmd.agent': 'Configura e inicia {name} vía TokenMix',
@@ -830,6 +835,7 @@ export const fr = {
     'cmd.topup': 'Ouvrir le navigateur pour recharger votre compte',
     'cmd.models': 'Lister les modèles disponibles avec les prix',
     'cmd.modelsType': 'Filtrer par type : chat | embedding | image | audio | video',
+    'cmd.modelsSearch': 'Filtrer les modèles par nom (correspondance partielle)',
     'cmd.list': 'Lister les agents de codage pris en charge',
     'cmd.doctor': 'Diagnostiquer la configuration de la CLI et l’installation des agents',
     'cmd.agent': 'Configurer et lancer {name} via TokenMix',

package/dist/program.js

@@ -46,6 +46,7 @@ export function buildProgram(deps = {}) {
         .command('models')
         .description(t('cmd.models'))
         .option('-t, --type <type>', t('cmd.modelsType'))
+        .option('-s, --search <keyword>', t('cmd.modelsSearch'))
         .action(modelsCommand);
     program
         .command('list')

package/dist/utils/logger.js

@@ -1,5 +1,15 @@
 import chalk from 'chalk';
 // Minimal CLI logger. Symbols are ASCII-friendly Unicode, not emoji.
+//
+// Output-stream contract (deliberate — keep it this way):
+//   • step()  → STDERR: progress narration ("Configuring…", "Launching…").
+//     Off stdout so `tokenmix kilo > config.txt`, piping an agent, or scripting
+//     `tokenmix balance` isn't polluted with our progress chatter.
+//   • error() → STDERR: failures.
+//   • success()/info()/warn()/dim() → STDOUT: these carry user-facing OUTPUT,
+//     not just chatter — `balance` prints figures via success(), `doctor` prints
+//     its report (incl. "not logged in"/"not installed") via success()/warn().
+//     Moving those to stderr would split a command's report across two streams.
 export const logger = {
     info(msg) {
         console.log(msg);
@@ -14,7 +24,7 @@ export const logger = {
         console.error(chalk.red('✗'), msg);
     },
     step(msg) {
-        console.log(chalk.cyan('→'), msg);
+        console.error(chalk.cyan('→'), msg);
     },
     dim(msg) {
         console.log(chalk.dim(msg));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenmix",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.",
   "type": "module",
   "bin": {